異步數據通知 · 商戶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，都將不繼續后續的通知。