支付结果通知
当支付状态扭转为终态,即支付成功或支付失败,聚合支付后台会根据notify_url地址,以事件通知的方式异步将支付结果回调给业务方。
业务方需自行实现接受逻辑处理回调信息。
业务方在接受到回调请求后,需在 5秒 内返回。如果 5秒 内收不到响应会断掉连接,并重新发起请求。平台会在12小时内,通过一定的策略(通知频率为 0s/15s/15s/30s/3m/10m/20m/30m/30/30m/1h/3h/3h/3h )间接性重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功。
回调公共参数
加密前参数
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| mch_id | 是 | String | 商户id |
| pay_no | 是 | String | 聚合支付订单号 |
| out_trade_no | 是 | String | 业务系统订单号 |
| transaction_id | 否 | String | 支付平台交易流水号。微信、支付宝、云闪付等用户支付使用的平台返回流水号 |
| ch_transaction_id | 否 | String | 间连渠道交易流水号。聚合或其他第三方间连渠道返回流水号 |
| payment | 是 | String | 支付方式 |
| subject | 是 | String | 商品名或订单简要描述 |
| amount | 是 | int | 交易金额,单位:分 |
| pay_time | 是 | String | 支付时间,格式"yyyy-MM-dd HH:mm:ss" |
| succ_time | 否 | String | 支付完成时间,只有在支付成功时返回,格式"yyyy-MM-dd HH:mm:ss" |
| status | 是 | int | 支付状态。参考支付状态值枚举 |
| attach | 否 | String | 附加信息,原样返回 |
| result_msg | 否 | String | 其他错误信息。当is_fresh为Y并且查询支付渠道失败时返回支付渠道的错误信息。 |
| amount_info | 否 | Json | 支付订单相关金额信息,支付成功时返回 |
回复参数
业务方接收到请求后,根据自身系统处理结果,返回平台纯字符串结果值,无需签名。
返回值如非"SUCCESS",平台将继续按策略重试发送通知。
| 返回结果 | 说明 |
|---|---|
| SUCCESS | 处理成功,平台收到此结果后不再进行后续通知 |
| FAIL或其他字符 | 处理不成功,平台将重试发送通知 |