创建代付订单
WARNING
注意:如果接口响应超时或者响应了非200的HTTP-CODE,请务必跟我们运营确认过订单状态后再提交
WARNING
必看:姓名+手机号+邮箱+金额为判定不同客户发起依据,所以建议商户对接中注意以下问题,否则容易产生风控误判。
- 不建议姓名、手机号、邮箱都写死
- 同一客户使用同一个姓名+手机号+邮箱
接口
POST /cashout/pakistan/order/create
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 是 | 客户名 — 越真实,成功率越高,触发风控系数越低,长度要求大于5 |
phone | string | 是 | 客户手机号 — 03开头11 位数字,phone 和 account 必须相同 |
email | string | 是 | 客户邮箱 — 越真实,成功率越高,触发风控系数越低 |
bankCode | string enum | 是 | 代付方式编码 — JAZZCASH, EASYPAISA |
account | string | 是 | 账号,巴基斯坦支持手机号 — 03开头11 位数字,phone 和 account 必须相同 |
amount | number | 是 | 金额 — 100~49999;最多小数点后两位,超过则四舍五入,带小数点的情况,注意如果是浮点型签名前的拼接中amount的值会省略小数点后末尾的0 |
notifyUrl | string | 是 | 通知地址 — 测试环境上支持自动回调,请求参数手机号最后一位奇数回调成功,偶数回调失败 |
sign | string | 是 | 签名 |
appId | string | 是 | 商户appId |
mchOrderNo | string | 是 | 商户订单号 |
mchId | integer | 是 | 商户号 |
txChannel | string | 是 | 交易通道 — 固定值TX_PAK_001 |
timestamp | integer | 是 | 当前时间戳 — 秒级时间戳 |
taxNumber | string | 是 | 证件号(CNIC) — 长度 13 位 |
branch | string | 是 | 国际银行账号 — IBAN必须以 PK 开头,总共有24个字符 |
请求示例
json
{
"mchId": 7937213261,
"txChannel": "TX_PAK_001",
"appId": "R22e9c0f1x3hycRKd9",
"timestamp": 1662450012,
"mchOrderNo": "payout_26622128134",
"name": "Matthew Clark",
"phone": "03881999382",
"email": "test@gmail.com",
"bankCode": "UPAY",
"account": "03881999382",
"amount": "500",
"taxNumber": "3123456789012",
"branch": "PK36SCBL0000001123456702",
"notifyUrl": "http://xmevj.kg/obp",
"sign": "xxxxxxxx"
}响应参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
status | integer | 是 | 状态 — 200成功 |
msg | string | 是 | 信息 |
data | object | 是 | |
data.applyTime | integer | 是 | 申请时间 |
data.amount | number | 是 | 到账金额 |
data.platOrderNo | string | 是 | 平台订单号 |
data.mchOrderNo | string | 是 | 商户订单号 |
data.orderStatus | string enum | 是 | 订单状态 — PENDING, SUCCESS, FAILED, REFUND |
响应示例
json
{
"status": 200,
"msg": null,
"data": {
"mchOrderNo": "payout_1662104438",
"platOrderNo": "wussXUCOoXO3yptr7rQV",
"applyTime": 1662104742,
"amount": 180.34,
"orderStatus": "PENDING"
}
}