交易结果后台通知
用户支付成功后,根据统一下单接口的异步通知地址,平台将用户支付结果通知商户,商户需要接收处理,并返回应答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) | |
支付方式 | payMethod | M | String(14) | 支付成功时返回,参见 支付方式 |
支付成功时间 | payTime | M | String(14) | 支付成功时返回 |
通知示例报文
json
{
"appId": "000110011816681",
"orderId": "Ea11dB5d-Ae3E-dE93-b21D-B2cA6EdCBC5D",
"transId": "2401081445566584201",
"orderName": "test",
"orderAmount": "1000",
"orderStatus": "success",
"payCurrency": "CNY",
"orderStartTime": "20240108144557",
"orderExpireTime": "20240108154557"
}