异步通知
针对交易结果,支付平台会通过异步消息的方式通知客户系统。
服务器为GET方式回调,默认超时时间为5秒,超时后会重试3次;不支持HTTP重定向
收到通知后请返回状态码“success”,响应异步通知。为了表示商户交易系统已经收到交易应答,客户必须在应答接收页面输出一段特殊的字符串,
如果收到商户的应答不符合规范或超时,接口认为通知失败,会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功。
| 参数名 |
参数值 |
可空 |
加入签名 |
说明 |
| 商户订单号 |
orderid |
否 |
是 |
支付过程中商户系统传入的订单号 |
| 支付状态 |
state |
否 |
是 |
0:支付成功,非0为支付失败 |
| 提交金额 |
amount |
否 |
是 |
单位元(人民币) |
| 平台订单号 |
sysorderid |
是 |
否 |
接口订单号 |
| 备注信息 |
attach |
是 |
否 |
备注信息,下行中会原样返回 |
| 签名 |
sign |
否 |
否 |
签名字符串,商户使用 "平台公钥" 对响应报文 进行验签 |
签名说明
异步通知示例:http://www.toxx.com/CallBackUrl.aspx?orderid=2022123017524694&state=0&amount=10.0000&sysorderid=22123017524726110699&attach=&sign=XXXXXXXXXXXXXXXXXXXXXXXXXXXX
具体待签名串及格式如下:orderid={0}&state={1}&amount={2}其中{}为占位符
验签结果 = RSA公钥验签(待签名串, sign, 平台公钥)
特别说明
异步通知过程在整个支付流程中一定存在。商户系统在收到通知过程后, 需向接口返回“success”。接口根据该返回值判断商户系统是否已经收到结果。如果收到商户的应答不符合规范或超时,接口认为通知失败,会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功