### 異步通知結果 對于API產生的交易，至尊會根據原始API中傳入的異步通知地址`notify_url`，通過POST請求的形式將`json`格式的支付結果作為參數通知到商戶系統。 **注：內部使用查看該文檔**：[http://www.hmoore.net/zzkpay/tongbao\_wendang/1390927](http://www.hmoore.net/zzkpay/tongbao_wendang/1390927) ### 異步通知參數 | 參數 | 參數名稱 | 類型 | 必填| 描述 | | --- | --- |--- | --- |--- | | notify_time | 通知時間 | Integer | 是 | 時間戳 | | notify_id | 通知校驗ID | String(32) | 是 | 通知校驗ID | | notify_type | 通知類型| Integer | 是 | 通知的類型 | | sourceCode | 渠道標識 | Integer | 是 | 至尊分配的唯一標識 | | order_on | 至尊交易號 | String | 是 | 交易憑證號| | out_order | 商戶訂單號 | String | 是 | 原支付請求的商戶訂單號 | | out_biz_no | 商戶業務號 | String | 否 | 商戶業務ID，主要是退款通知中返回退款申請的流水號 | | order_time | 交易時間 | Integer | 是 | 時間戳 | | amount | 交易金額 | Integer | 是 | 類型的交易金額，以`分`為單位 | | passback_params | 回傳參數 | String(512) | no | 公共回傳參數，如果請求時傳遞了該參數，則返回給商戶時會在異步通知時將該參數原樣返回。本參數必須進行UrlEncode之后才可以發送給至尊 | | errcode | 狀態碼 | String | 是 | 狀態碼 統一`0`為成功 | | errmsg | 狀態說明 | String | 是 | 狀態說明 | | sign | 簽名 | String | 是 | 請參考[新簽名算法](http://www.hmoore.net/zzkpay/zzkpay/1224541) | #### notify_type 通知類型 | 狀態碼 | 說明 | | --- | --- | | 1 | 余額充值 | | 2 | 余額消費 | | 3 | 余額退款 | | 4 | 余額充值撤銷 | | 5 | 通寶消費 | | 6 | 通寶通寶退款 | | 7 | 充電余額消費 | ### 服務器異步通知頁面特性 * 必須保證服務器異步通知頁面（notify_url）上無任何字符，如空格、HTML標簽、開發系統自帶拋出的異常提示信息等； * **只有在至尊的交易管理中存在該筆交易，且發生了交易狀態的改變，至尊才會通過該方式發起服務器通知；** * 服務器間的交互，不像頁面跳轉同步通知可以在頁面上顯示出來，這種交互方式是不可見的； * 第一次交易狀態改變（即時到賬中此時交易狀態是交易完成）時，不僅會返回同步處理結果，而且服務器異步通知頁面也會收到至尊發來的處理結果通知； * **程序執行完后必須打印輸出“success”（不包含引號）。如果商戶反饋給至尊的字符不是success這7個字符，至尊服務器會不斷重發通知，直到超過24小時22分鐘。一般情況下，25小時以內完成8次通知（通知的間隔頻率一般是：4m,10m,10m,1h,2h,6h,15h）；** * 程序執行完成后，該頁面不能執行頁面跳轉。如果執行頁面跳轉，至尊會收不到success字符，會被至尊服務器判定為該頁面程序運行出現異常，而重發處理結果通知； * cookies、session等在此頁面會失效，即無法獲取這些數據； * 該方式的調試與運行必須在服務器上，即互聯網上能訪問； * 該方式的作用主要防止訂單丟失，即頁面跳轉同步通知沒有處理訂單更新，它則去處理； * 當商戶收到服務器異步通知并打印出`success`時，服務器異步通知參數`notify_id`才會失效。也就是說在至尊發送同一條異步通知時（包含商戶并未成功打印出`success`導致支付寶重發數次通知），服務器異步通知參數`notify_id`是不變的。