实时收款方信息付款
接口信息
- 路径:
/api/v2/txn/remittance - 方法: POST
- Content-Type: application/json
业务说明
- 支持指定付款金额和预计到账金额2种模式
- 指定付款金额，付款金额扣除手续费后作为预计到账金额
- 指定预计到账金额，手续费累加预计到账金额作为付款金额
- 支持付款发起时，填写付款方详情字段
- 该接口目前有使用限制，使用前请与我们联系
请求参数
Headers
请求头
| 参数名 | 值 | 必填 | 说明 |
|---|---|---|---|
| Content-Type | application/json | 是 | 请求体类型 |
Request Body
主要参数
| 参数名 | 类型 | 说明 | 必填 |
|---|---|---|---|
| merchantNo | string | 商户号 | M |
| payerId | integer | 付款方ID | C |
| payerDetail | string | 付款方信息（注意，payerId和payerDetail 二选一） | C |
| sourceAmount | number | 源金额 | C,当chargeFlag为N时必填 |
| sourceCurrency | string | 源币种 | M |
| targetAmount | number | 目标金额 | C,当chargeFlag为Y时必填 |
| targetCurrency | string | 目标币种 | M |
| requestId | string(32) | 业务流水号，由商户填写，每笔付款保证唯一。 | M |
| reference | string(256) | 交易附言 | C |
| transactionPurpose | string(64) | 交易用途 | M |
| chargeFlag | string | 全额到账 | M |
| bankCountry | string(12) | 付款国家 | M |
| payoutCurrency | string(128) | 出款币种 | M |
| entityType | string(1) | 主体类型 [0:企业,1:个人] | M |
| paymentMethod | string | 付款方式 | M |
| receiverInfo | string(1024) | 收款人信息 | M |
| address | string(1024) | 地址信息 | M |
| accountInfomation | string(1024) | 账户信息 | M |
| sign | string | 签名 | M |
请求示例
json
{
"merchantNo": "801022",
"payerId":1953712585351499776,
"payerDetail":"{\"createTime\":\"2025-08-16 14:21:57\",\"merchantNo\":\"801040\",\"country\":\"CN\",\"addressEn1\":\"Nanshan Science & Technology Park, Shenzhen\",\"addressEn2\":\"2all\",\"addressEn3\":\"3\",\"postcode\":\"518057\",\"status\":0,\"email\":\"1@qq.com\",\"areaCode\":\"+86\",\"phoneNumber\":\"15072871023\",\"state\":\"hubei\",\"city\":\"wuhan\",\"subEntityType\":\"1\",\"firstName\":\"zhang\",\"lastName\":\"san2\",\"idType\":\"0\",\"idNumber\":\"371328198410044019\",\"birthDate\":\"1984-10-04\",\"idValidDateFrom\":\"2016-08-04\",\"idValidDateTo\":\"2026-08-04\"}",
"sourceAmount": 113.00,
"sourceCurrency": "USD",
"targetAmount": 1901.00,
"targetCurrency": "PKR",
"requestId": "DM2025081120520",
"reference": "REFERENCE PAYPAL",
"transactionPurpose": "4",
"chargeFlag": "Y",
"bankCountry": "US",
"payoutCurrency": "USD",
"entityType": "1",
"paymentMethod": "BANK_TRANSFER",
"receiverInfo": "{\"nickName\":\"USTEST12\",\"companyName\":\"\",\"lastName\":\"USDMDD\",\"firstName\":\"DAN\",\"areaCode\":\"\",\"phone\":\"\",\"email\":\"hynchen@onerway.com\",\"identityType\":\"SSN\"}",
"address": "{\"countryCode\":null,\"state\":\"CALIFORNIA\",\"city\":\"Adin\",\"addressLine1\":\"ADRESS TEST 1\",\"addressLine2\":null,\"addressLine3\":null,\"postalCode\":\"890890\"}",
"accountInfomation": "{\"cardNumber\":\"3890601780555\",\"accountType\":\"1\",\"swiftCode\":\"ABOCUS33\",\"bankName\":\"MCB BankLimited\",\"sortCode\": \"021001088\", \"bankAccount\": \"AGRICULTURAL BANK OF CHINA NEW YORK BRANCH\"}",
"sign": "d2ea92efff636320122021f65b613201403f6d34334cfbc7e589ce9f842988f7"
}响应结果
响应头 Headers
| 参数名 | 值 | 必填 | 说明 |
|---|---|---|---|
| content-type | application/json;charset=UTF-8 | 是 | 响应体类型 |
响应参数
响应字段
| 参数名 | 类型 | 说明 |
|---|---|---|
| respCode | string | 响应码 |
| respMsg | string | 响应信息 |
| data | object | 响应数据 |
| └─merchantNo | integer | 商户号 |
| └─payoutId | integer | 付款流水ID |
| └─status | string | 状态 |
| └─requestId | string | 付款流水ID |
响应示例
json
{
"respCode": "20000",
"respMsg": null,
"data": {
"merchantNo": "801022",
"payoutId": "1967418277869780992",
"status": "A",
"requestId": "DM2025081120520"
}
}