连连开放平台文档

付汇申请

POST/v1/global-payout/payout-apply

请求参数

mch_id

string

商户编号

必需

商户在平台上开设的商户号码，为18位数字，如：201304121000001004

<= 18 字符

sub_mch_id

string

子商户号

可选

子商户号（平台商模式下必传），为18位数字

txn_seqno

string

付汇申请唯一交易流水号

必需

<= 64 字符

beneficiary_id

string

收款人id

必需

商户系统内申报成功的收款人id

<= 64 字符

pay_currency

enum<string>

付款币种

必需

当前仅支持CNY

枚举值:

CNY

send_currency

string

到账币种

必需

三位标准格式，参考：https://www.iban.hk/currency-codes

pay_amount

string

付款金额

必需

最大值：99999999.99

<= 12 字符

示例值:

1.01

payer_info

object

付款方信息

可选

如果不上送payer_info信息，则默认从平台自有可用账户扣除资金

user_id

string

付款方id

必需

只有从平台下二级账户出资付汇的情况下，才需要上送二级账户外部用户号，上送二级账户外部用户号时余额将会从用户自有可用账户扣除资金，如果不上送payer_info信息，则默认从平台自有可用账户扣除资金

<= 64 字符

password

string

支付密码

必需

random_key

string

密码随机因子key

必需

<= 256 字符

pap_agree_no

string

委托协议号

必需

委托代发协议号。用户在ACCP开通的委托提现协议号。通过用户委托协议签约接口获取。授权免密提现时必输。该字段需要RSA公钥加密传输。

<= 32 字符

rate_id

string

汇率id

可选

锁汇接口响应，上送汇率id需确保在汇率有效期内否则会直接拦截

<= 32 字符

memo

string

附言

必需

支持英文、数字、特殊字符；字符仅支持 ,.-

<= 256 字符

notify_url

string

异步通知地址

必需

付汇申请结果终态通知地址

<= 256 字符

business_type

enum<string>

业务场景

必需

<= 32 字符

枚举值:

ECOMMERCE

{
  "mch_id": "string",
  "sub_mch_id": "string",
  "txn_seqno": "string",
  "beneficiary_id": "string",
  "pay_currency": "CNY",
  "send_currency": "string",
  "pay_amount": "1.01",
  "payer_info": {
    "user_id": "string",
    "password": "string",
    "random_key": "string",
    "pap_agree_no": "string"
  },
  "rate_id": "string",
  "memo": "string",
  "notify_url": "string",
  "business_type": "ECOMMERCE"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

返回码

必需

ret_msg

string

返回码描述

必需

mch_id

string

商户编号

可选

商户在平台上开设的商户号码，为18位数字，如：201304121000001004

txn_seqno

string

付汇申请唯一交易流水号

可选

platform_txno

string

平台订单号

可选

受理成功时返回，平台订单号，连连订单唯一编号

txn_status

enum<string>

付汇申请状态

可选

枚举值:

PROCESSINGFAIL

{
  "ret_code": "string",
  "ret_msg": "string",
  "mch_id": "string",
  "txn_seqno": "string",
  "platform_txno": "string",
  "txn_status": "PROCESSING"
}