9 注意事項

1、 所有涉及到金額的單位都是幣種的最小單位,不能有小數出現

2、notify_url 是平臺伺服器從後臺直接發起請求到商戶伺服器,商戶處理時不能檢查用戶的 cookie 或 session: 商戶更新 DB 等發貨流程需要在 notify_url 完成後,以確保掉單時,平臺補單能成功補上

3、notify_url 有可能重複通知,商戶需要做去重處理,避免多次發貨

4、notify_url收到的通知,商戶處理成功或檢查訂單已經處理,需要返回處理成功的標誌純字串success,字串success不區分大小寫;如果我們沒有收到返回的 success,我方伺服器繼續向你們發送通知,在三小時後將不再通知;假設所有訂單都沒有返回success,將增加我們伺服器的通知負載,最壞的情況,可能就是導致正常通知商戶的通知發生延遲;另外我們會催促你們完善,如果長期不改善,研發或運維技術將對貴司開通的支付接口採取控制措施。

5、 文檔中請求接口時傳的參數,必填為是的參數是必須要傳的(如有缺少會報錯),必填為否的參數可以傳也可以不傳

6、 返回參數中必填為是的參數是一定會返回的,必填為否的參數則不一定返回,因升級或配置等情況實際返回參數可能不會跟文檔完全一致,必須以實際接收到的參數為准

7、 關於用戶 openid:在關注者與公眾號產生消息交互後,公眾號可獲得關注者的 OpenID(加密後的微信號,每個用戶對每個公眾號的 OpenID 是唯一的。對於不同公眾號,同一用戶的 openid 不同)獲取 openid 可參考以下地址:https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140842&token=&lang=zh_CN 使用測試商戶號不需要傳用戶 openid;切換正式的商戶號需獲取 openid,在請求參數裏增加 sub_openid字段,並把獲取的 openid 值傳給 sub_openid。在切換成正式商戶號傳 sub_openid參數前,需提供正式商戶號和公眾號(服務號)appid由服務商配置(一般是通過郵件發送配置表),如果沒有配置的話,會報 sub_appidand su_openidnotmatch 錯誤,導致無法正常調用接口

8、 其他注意事項

(1) 參數大小寫問題 請留意文檔中要求的字元大小寫問題, 如 “md5 運算後, 字串的字元要轉換為大寫” 。

(2) 參數格式問題

所有傳入參數,均為字串類型,請注意文檔中各處的具體要求。

(3) 時間戳問題 請使用 Linux 時間戳,注意為字串格式。

(4) 同一商戶訂單號支付問題

商戶訂單支付失敗需要生成新單號重新發起支付,要對原訂單號調用關單,避免重複支付;系統下單後,用戶支付超時,系統退出不再受理,避免用戶繼續,請調用關單接口。

注意:訂單生成後不能馬上調用關單接口,最短調用時間間隔為 5 分鐘。