交易结果后台通知
用户支付成功后,根据统一下单接口的异步通知地址,平台将用户支付结果通知商户,商户需要接收处理,并返回应答SUCCESS=Y。
注意
- 同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。
- 后台通知交互时,如果平台收到商户的应答不是SUCCESS=Y或超时,平台认为通知失败,并通过一定的策略重新发起通知,会尽可能提高通知的成功率,但不保证通知最终能成功。建议商户也同时接入状态查询接口。
- 重复通知时间间隔如下:30秒、2分钟、10分钟、30分钟、1小时、2小时、6小时、10小时、15小时。
- 同步返回:SUCCESS=Y,表示通知成功,否则平台后端会按照通知补发规则重发通知。
业务请求参数
| 字段名称 | 字段key | 必填 | 格式 | 备注 |
|---|---|---|---|---|
| 应用编号 | appId | M | String(1,40) | 商户后台创建的应用ID |
| 商户订单号 | orderNo | M | String(1,40) | |
| 平台订单号 | transId | M | String(1,64) | |
| 商户商品名称 | orderName | M | String(1,128) | |
| 订单金额 | orderAmount | M | Number(1,22) | |
| 交易状态 | orderStatus | M | String(1,10) | 参见 交易状态 |
| 支付币种 | payCurrency | M | String(3) | 参见 货币列表 |
| 订单开始时间 | orderStartTime | M | String(14) | |
| 订单过期时间 | orderExpireTime | M | String(14) |
后台通知示例报文
json
{
"appId": "000110011816681",
"orderId": "4FfDAfec-F18E-FfFe-7c64-D37B4e4Cc723",
"transId": "2401080950056440203",
"orderName": "test",
"orderAmount": "1000",
"orderStatus": "success",
"payCurrency": "INR",
"orderStartTime": "20240108095005",
"orderExpireTime": "20240108105005"
}