主题
商户代付
接口描述
- 由商户发起，将商户资金转入到指定银行卡账户的过程。支持对公对私卡。
请求URL
/merchant/defray/commit
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202415629590370906 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| merchantNo | 是 | string | 32 | 商户编号 | XS240820000054 |
| bankAccountType | 是 | string | 32 | 收款方银行账户类型 BC-对公账户；BU-对私账户 | |
| outTradeNo | 是 | string | 20 | 商户订单号 | |
| amount | 是 | String | 代付金额 | 单位：分 | |
| bankAccountName | 是 | string | 银行账户名称(需要AES加密) | ||
| bankAccountNo | 是 | string | 255 | 银行账户号(需要AES加密) | |
| certType | 否 | string | 32 | 证件类型 | 身份证：ID_CARD |
| certNo | 否 | string | 证件号(需要AES加密) | ||
| branchNo | 否 | string | 银行支行联行号 对公账户必传 | ||
| notifyUrl | 否 | string | 通知地址 |
请求报文示例
json
{
"appId": "202415629590370906",
"merchantNo": "XS241026000093",
"bankAccountType": "yoyipay1jcd7fu45tk01",
"outTradeNo": "18511110003547765",
"amount": "100",
"bankAccountName": "张三",
"bankAccountNo":"56555555",
"certType":"ID_CARD",
"certNo":"310101198911022323",
"branchNo":"
"signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
"transDate": "1731469621597",
"transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| defrayNo | 是 | string | 32 | 支付系统代付流水号 | 31202507021940368626422427649 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"tradeNo": "1856544267009564674",
"transDate": "1731469621597",
"transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
"signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g=="
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述