代付异步通知(商户提供)
WARNING
本接口由商户提供,当代付成功或者失败时,平台请求该接口 接收到服务器点对点通讯时,请响应httpcode=200(HTTP 响应状态码),否则会重复5次发送点对点通知. 该接口的响应时间请务必在3s内响应,如超3s响应,系统将当做回调失败处理!
最佳实践(必看)
- 对于支付成功的判定,需判定status和orderStatus状态,即status==200&&orderStatus="SUCCESS"
- 对于退款的判定:status==200&&orderStatus="REFUND"。这种情况一般是出现在银行风控退回,请商户做好相关记录并根据自身业务逻辑进行处理(收到此回调状态之前会先收到回调成功)
- 若是商户业务逻辑上处理失败,请将响应的HTTP状态码改为400或者500(非200) 4.平台可能会多次发送相同状态的回调,请商户做好相关兼容处理,如商户自身业务已经处理完成,请务必返回响应HTTP状态码200
- 请务必校验回调IP➕验证签名
- 请务必尽量保证接口的响应时间
测试环境回调IP
13.214.67.82
接口
POST /callback_url
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
status | integer | 是 | 状态 — 200成功 |
msg | string | 是 | 信息 |
memberId | string | 是 | 商户id |
mchOrderNo | string | 是 | 商户订单号 |
platOrderNo | string | 是 | 平台订单号 |
orderStatus | string | 是 | 订单状态 |
amount | number | 是 | 到账金额 |
fee | number | 是 | 手续费 |
sign | string | 是 | 验签 |
timeEnd | integer | 是 | 完结时间戳 — 秒级时间戳 |
utr | string | 否 | utr(仅印度) |
请求示例
json
{
"status": 200,
"memberId": "16001",
"mchOrderNo": "20220721144249483",
"platOrderNo": "3KITxA1dEXhZ2IRXvwck",
"orderStatus": "SUCCESS",
"amount": 10000,
"fee": 100,
"timeEnd": 1658387041,
"sign": "VJ0pQTRvHI7Tlc8TVodYOlDZzyxcDIJumD5pit+/eFcGYInT9ynePuyGXAqnoqrxeEvNbtN++DYd5J2oG16CIQU8qX9XFMj4o+DNPuUzNdaF06HhlkUxwPTTeSWCDOuw2XPtMRY0u8T/KA2PbzrX2lr4I6siICZaDHeocjO9PI0=",
"msg": "success"
}