异步数据通知 · 商户API对接文档

<p style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)"> 异步通知数据  <p style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)"> 处理完数据后一定要输出success字符串，这样平台才会认为异步通知成功了 <p style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)"> 系统将订单交易结果异步发送给渠道系统异步地址由技术人员配置只有成功的订单才有异步通知，其他，状态请根据订单查询接口轮询结果 <table width="776"> <tbody style="box-sizing: inherit"> <tr style="box-sizing: inherit;height: 34px" class="firstRow"> <td width="26" style="box-sizing: inherit;border-color: black;padding: 0px 7px"> 变量名 </td> <td width="11" style="box-sizing: inherit;border-top-color: black;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 是否为空 </td> <td width="61" style="box-sizing: inherit;border-top-color: black;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 说明 </td> </tr> <tr style="box-sizing: inherit;height: 46px"> <td width="26" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left-color: black;padding: 0px 7px"> appid </td> <td width="11" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 否 </td> <td width="61" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 商户号终端APPID </td> </tr> <tr style="box-sizing: inherit;height: 43px"> <td width="26" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left-color: black;padding: 0px 7px"> method </td> <td width="11" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 否 </td> <td width="61" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 接口支付类型参考各接口method </td> </tr> <tr style="box-sizing: inherit;height: 43px"> <td width="26" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left-color: black;padding: 0px 7px"> status </td> <td width="11" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 否 </td> <td width="61" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 支付状态 0未支付/待支付 1支付成功 2退款成功 </td> </tr> <tr style="box-sizing: inherit;height: 43px"> <td width="26" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left-color: black;padding: 0px 7px"> out_trade_no </td> <td width="11" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 否 </td> <td width="61" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 平台订单号 </td> </tr> <tr style="box-sizing: inherit;height: 43px"> <td width="26" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left-color: black;padding: 0px 7px"> u_out_trade_no </td> <td width="11" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 否 </td> <td width="61" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 商户订单号 </td> </tr> <tr style="box-sizing: inherit;height: 43px"> <td width="26" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left-color: black;padding: 0px 7px"> transaction_id </td> <td width="11" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 否 </td> <td width="61" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 官方订单号成功状态订单不为空 </td> </tr> <tr style="box-sizing: inherit;height: 43px"> <td width="26" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left-color: black;padding: 0px 7px"> total_fee </td> <td width="11" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 否 </td> <td width="61" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 交易金额单位:分 </td> </tr> <tr style="box-sizing: inherit;height: 43px"> <td width="26" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left-color: black;padding: 0px 7px"> create_time </td> <td width="11" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 否 </td> <td width="61" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 订单创建时间 </td> </tr> <tr style="box-sizing: inherit;height: 43px"> <td width="26" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left-color: black;padding: 0px 7px"> nonce_str </td> <td width="11" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 否 </td> <td width="61" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 随机字符串 </td> </tr> <tr style="box-sizing: inherit;height: 43px"> <td width="26" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left-color: black;padding: 0px 7px"> sign </td> <td width="11" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 否 </td> <td width="61" style="box-sizing: inherit;border-top: none;border-right-color: black;border-bottom-color: black;border-left: none;padding: 0px 7px"> 数据签名参考数据签名规则 </td> </tr> </tbody> </table> <p style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)">   <p style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)"> 说明 <p style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)"> 异步通知地址，由商户进入后台“接口信息”内进行配置，每套Appid只能配置一条异步通知地址，可修改支付成功的订单，会返回异步通知结果，异步通知有可能由于外部因素造成延迟，所以对实时要求高的场景请调用查询接口查询，建议异步通知与查询接口配合使用。由于安全原因，异步通知仅支持80(http)和 443(https)端口，不支持自定义指定端口。 <p style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)">   <p style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)"> 异步数据验签： <p style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)"> 除了sign其余所有字段参与签名即可 <p style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)">  异步通知发送规则： <p class="MsoListParagraph" style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;margin-left: 24px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)"> ①    异步通知的地址提供给技术支持，在后台系统设定好。 <p class="MsoListParagraph" style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;margin-left: 24px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)"> ②    交易成功后，系统会以json格式POST到设定好的异步通知地址上。 <p class="MsoListParagraph" style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;margin-left: 24px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)"> ③    开发者，收到异步通知后，验证签名通过后，需要给系统返回SUCCESS(不区分大小写)字符串，表示已处理异步通知数据 <p class="MsoListParagraph" style="box-sizing: inherit;line-height: 2;margin-top: 0px;margin-bottom: 0px;margin-left: 24px;padding: 0px;color: rgb(82, 82, 82);font-family: 'Helvetica Neue', NotoSansHans-Regular, AvenirNext-Regular, arial, 'Hiragino Sans GB', 'Microsoft Yahei', 'WenQuanYi Micro Hei', serif;font-size: 15px;white-space: normal;background-color: rgb(252, 252, 252)"> ④    若开发者给系统返回其他的数据，或者没有任何返回，那么我方会以一定的策略再次发送异步通知，时间间隔是1m、5m、10m、60m、2h、6h、15h，期间任何一次收到SUCCESS，都将不继续后续的通知。