跳转到内容

代付创建

API TEST CONSOLE

模拟请求

TEST ONLY

测试环境下配置参数并发送请求

POST/trade/payout/create

请求鉴权

待配置

私钥仅在浏览器内用于生成 authorization,不会随请求发送或保存

请求头

请求参数 application/json

响应结果

Response
发送请求后,响应状态、耗时和 JSON 将显示在这里。

认证信息仅保留在当前页面内存中,不会写入本地存储。

复制 cURL 不会发送请求

POST/trade/payout/create

请求头

公共请求头。

支付方式参数

payoutType
BANK_TRANSFER
BANKTRANSFER_KYC

请求参数

字段类型必填最大长度说明
merchantOrderNoString是32商户订单号
transactionAmountString是20付款金额,整数(保留 2 位小数)
payoutTypeString是20代付方式
idTypeString是50收款人类型:RRN(个人)或 CO(企业)
userIdCardString否50证件号码。个人 RRN 为 13 位数字;企业 CO 为 10 位企业登记号;当前接口不强制传入
userNameString是64用户姓名
userPhoneString否11用户手机号码,11 位数字,以 010 开头
userEmailString否50用户邮箱
bankCodeString是20银行编码
bankNameString是50银行名称
bankAccountNoString是50收款账户
descriptionString否100说明
payoutCallbackUrlString否200代付回调地址

请求示例

{
"merchantOrderNo": "PAYOUT202609170001",
"transactionAmount": "100.00",
"payoutType": "BANK_TRANSFER",
"idType": "RRN",
"userIdCard": "9001011234567",
"userName": "TEST USER",
"userPhone": "01012345678",
"userEmail": "user@example.com",
"bankCode": "088",
"bankName": "Shinhan Bank",
"bankAccountNo": "1234567890",
"description": "Payout order",
"payoutCallbackUrl": "https://merchant.example/payout-callback"
}

响应参数

字段类型必填最大长度说明
codeint是-状态码,非 200 代表异常
dataObject是-响应体
data.merchantOrderNoString是32商户订单号
data.tradeNoString是32平台单号
data.transactionAmountString是-付款金额
data.statusString是24订单状态
data.payoutTypeString是24代付方式
msgString否-异常信息
tidString是-traceId

响应示例

{
"code": 200,
"data": {
"merchantOrderNo": "PAYOUT202609170001",
"tradeNo": "VF2405220001KR0000508467743993",
"transactionAmount": "100.00",
"status": "PAYING",
"payoutType": "BANK_TRANSFER"
},
"msg": "success",
"tid": "747bbf80261844ed85b809212aab0d81"
}