通过收款方ID发起付款

接口信息

• 路径: /api/v1/txn/remittance
• 方法: POST
• Content-Type: application/json

业务说明

• 核心付款接口
• 前置条件:必须使用已审核通过的收款人ID(beneficiaryId)
• 支持全额到账和非全额到账两种模式
• 付款前先确认收款人状态和额度等信息

请求参数

Headers

请求头

参数名	值	必填	说明
Content-Type	application/json	是	请求体类型

Request Body

主要参数

参数名	类型	说明	必填
merchantNo	string	商户号	M
payerId	integer	付款方ID	C
payerDetail	string	付款方信息（注意，payerId和payerDetail 二选一）	C
beneficiaryId	integer	受益人ID	M
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
feeBearing	string	swift付款手续费承担方式	C (当付款方式是为SWIFT时，必填，否则不要填)
sign	string	签名	M

请求示例

Request

{
  "merchantNo": "801040",
  "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\"}",
  "beneficiaryId": 1953727182141784064,
  "sourceAmount": 113.00,
  "sourceCurrency": "USD",
  "targetAmount": 1901.00,
  "targetCurrency": "PKR",
  "requestId": "DM2025081120520",
  "reference": "REFERENCE PAYPAL",
  "transactionPurpose": "4",
  "chargeFlag": "Y",
  "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

响应示例

Response

{
    "respCode": "20000",
    "respMsg": null,
    "data": {
        "merchantNo": "801129",
        "payoutId": "1984136974445449216",
        "status": "A",
        "requestId": "CYPW20251031055450"
    }
}