请求代收
WARNING
必看:姓名+手机号+邮箱+金额为判定不同客户发起依据,所以建议商户对接中注意以下问题,否则容易产生风控误判。
- 不建议姓名、手机号、邮箱都写死
- 同一客户使用同一个姓名+手机号+邮箱
接口
POST /cashin/thb/order/create
请求头
| 名称 | 必填 | 示例 | 说明 |
|---|---|---|---|
Content-Type | 是 | application/json |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
bankCode | string enum | 是 | 银行编码 — 请查看BankCode编码章节 — UPI |
amount | number | 是 | 订单金额 — 最多小数点后两位,超过则四舍五入,带小数点的情况,注意如果是浮点型签名前的拼接中amount的值会省略小数点后末尾的0 |
notifyUrl | string | 是 | 通知回调地址 — 测试环境上支持自动回调,请求参数手机号最后一位奇数回调成功,偶数回调失败 |
name | string | 是 | 客户名称 — 越真实,成功率越高,触发风控系数越低 |
phone | string | 是 | 客户电话 — 66开头,后跟7-12位数字,总长度为十位数字泰国手机号格式,越真实,成功率越高,触发风控系数越低 |
email | string | 是 | 客户邮箱 — 越真实,成功率越高,触发风控系数越低 |
sign | string | 是 | 签名 |
appId | string | 是 | 商户appId — 平台分配商户appId |
mchOrderNo | string | 是 | 商户订单号 |
mchId | integer | 是 | 商户号 |
timestamp | integer | 是 | 提交时间 — 秒级时间戳 |
txChannel | string | 是 | 交易通道 — 固定值 |
returnUrl | string | 否 | 收银台页面跳转地址 |
productInfo | string | 是 | 产品信息 |
请求示例
json
{
"mchId": 399204155797661,
"txChannel": "TX_THAILAND_001",
"appId": "DFN19SJXfxFCexeLIi",
"timestamp": 16624500121,
"mchOrderNo": "order_1672451031",
"bankCode": "BANK",
"amount": 5000,
"name": "Timothy Gonzalez",
"phone": "66688984423",
"email": "w.gssdyohqr@chvro.cy",
"productInfo": "xxx-Rechange",
"notifyUrl": "http://wxyiwtonif.sj/vpuu",
"returnUrl": "https://www.baidu.com/",
"sign": "xxxxxxxx"
}响应参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
status | integer | 是 | 状态 |
msg | string | 是 | 信息 |
data | object | 是 | 数据 |
data.applyTime | integer | 是 | 申请时间 — 时间戳格式 |
data.amount | number | 是 | 实际支付金额 |
data.link | string | 是 | 支付链接 |
data.expireTime | integer | 是 | 过期时间 — 时间戳格式 |
data.mchOrderNo | string | 是 | 商户订单号 |
data.platOrderNo | string | 是 | 平台订单号 |
data.reference | string | 是 | 参考码 |
响应示例
json
{
"status": 200,
"msg": null,
"data": {
"link": "https://s.xxxbxxxxxdpay.pw/pay/3661235101151a67b138e6a13049f782",
"mchOrderNo": "php_1698144286763",
"platOrderNo": "P_231024QiRN7KyNWTb0R7fWoVuN",
"applyTime": 1698144286,
"amount": 0,
"reference": null,
"expireTime": 1698144888
}
}