创建代付
请求地址
method | url |
---|---|
POST | /api/pay/payout/create/v1 |
头部信息(header)
header参数 | 入参参数描述 |
---|---|
timestamp | 请求时间戳 |
nonce | 随机值 |
country | PK |
app_code | app编号 |
请求参数
字段 | 类型 | 必需 | 最大长度 | 描述 |
---|---|---|---|---|
merchantOrderNo | String | yes | 32 | 商户订单号 |
amount | String | yes | 20 | 代付金额 巴基斯坦卢比 需传整数 |
bankCode | String | yes | 50 | 银行编码 301取bankCode,302时取WalletCode |
bankName | String | yes | 50 | 银行名称 与银行编码字段相同 |
accountType | Int | yes | 账户类型 301(BANK) 302(E-Wallet) | |
bankAccount | String | yes | 255 | 银行/钱包账户 |
realName | String | yes | 255 | 客户姓名 |
idCardNumber | String | yes | 13 | 证件号 13位数字 |
idType | Stirng | yes | 32 | 固定传CERT |
phone | Stirng | yes | 10 | 用户电话 10位数字 |
Stirng | no | 64 | 用户邮箱 | |
userIBAN | Stirng | no | 64 | 国际银行账号 |
callbackUrl | String | no | 200 | 代付回调地址,若不传, 则以商户配置为准 |
sign | String | yes | 签名 |
{ "merchantOrderNo": "2503231308020924", "amount": "1000", "bankCode": "EASYPAISA", "bankName": "EASYPAISA", "accountType": "302", "bankAccount": "3000000000", "realName": "TEEMO", "idCardNumber": "3000000000000", "idType": "CERT", "phone": "3000000000", "callbackUrl": "https://www.callbackexample.com", "sign": "YOUR_SIGN"}
返回参数
参数 | 类型 | 必需 | 长度 | 描述 |
---|---|---|---|---|
merchantOrderNo | String | yes | 32 | 商户订单号 |
tradeNo | String | yes | 平台订单号 | |
status | Int | yes | 代付状态,1:支付中 3:失败(可以重新发起) | |
amount | String | yes | 交易金额 |
{ "msg": "success", "traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610298", "code": 200, "data": { "amount": "1000", "merchantOrderNo": "OrderNoExample", "status": 1, "tradeNo": "TF2501010001CPK0000000000000000" }}
{ "code": 425, "data": null, "msg": "Insufficient merchant balance", "traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610298"}