## **掃碼支付成功通知** ## **注**：通知 URL 是代理商后臺配置的通知地址。掃碼支付成功后，樂刷會把相關支付信息和用戶信息發送到該 URL，商戶需要接收處理信息。對后臺通知交互時，如果收到商戶的應答不是成功或者超時，樂刷認為通知失敗，會通過一定的策略定期重新發起通知，盡可能的提高通知的成功率，但是不保證通知最終一定能成功。由于存在重復發送后臺通知的情況，因此同樣的通知可能會多次發送給商戶系統。系統必須能夠正確處理重復的通知。 - 驗證簽名方法：通知的 error_code、sign 字段不參與簽名，簽名方式參照數據格式及數據簽名說明，其中簽名 key 統一由樂刷提供。另外，組織簽名串時空值也參與簽名。 **通知參數** | 字段名 | 變量名| 必填 | 長度限制 | 類型 | 說明 | | ---------- | ------------------ | ---- | -------- | ------ | ----------------------------- | |錯誤碼|error_code|否|無|string|參照錯誤碼信息參照表| |簽名|sign|是|32|string|MD5 簽名結果| |商戶號|merchant_id|是|10|string|樂刷商戶號| |樂刷訂單號|leshua_order_id|是|32|string|| |商戶訂單號|third_order_id|是|64|string|| |訂單金額|amount|是|無|string|| |訂單狀態|status|是|無|string|[見下方訂單狀態](#訂單狀態)| |支付類型|pay_way|是|無|string|[見下方支付類型](#支付類型)| |支付時間|pay_time|是|無|string|'2018-08-20 19:19:19'| |銀行類型|bank_type|否|無|string|| |用戶openid|openid|否|無|string|| |微信、支付寶等訂單號|out_transaction_id|否|無|string|| |用戶子標識|sub_openid|否|無|string|支付成功時才返回。微信：子商戶appid 下用戶唯一標識；支付寶：買家的支付寶用戶id；| |附加數據|attach|否|96|string|支付成功時才返回。原樣返回| |交易類型|trade_type|否|無|string|支付成功時才返回。（1）MICROPAY--刷卡支付/條碼支付（2）NATIVE--原生掃碼支付（3）JSAPI--公眾號支付/服務窗支付（4）APP--app支付（5）H5Pay-支付支付（6）SmPgPay-小程序支付（7）JSAPIQuick-簡易支付| |通道訂單號|channel_order_id|否|無|string|支付成功時才返回| |通道訂單時間|channel_datetime|否|無|string|支付成功時才返回| |支付寶紅包金額|coupon|否|無|string|支付成功時才返回，單位：分| |應結算金額|settlement_amount|否|無|string|實際結算金額，支付成功時才返回，單位：分| |折扣優惠金額|discount_amount|否|無|string|本訂單優惠金額，支付成功時才返回，單位：分| |優惠詳情|promotion_detail|否|無|string|優惠詳情：[微信官網](https://pay.weixin.qq.com/wiki/doc/api/danpin.php?chapter=9\_101&index=1) | |活動標志|active_flag|否|無|string|活動標志：WXLZ：微信綠洲，ZFBLH：支付寶藍海| **返回參數** |字段名|說明| |---|---| |0000000|通知成功，樂刷收到此返回后不會繼續通知| |其他|樂刷收到回復或者未收到回復，系統會再次通知。為避免資源浪費，請核實并確保響應信息的準確性，可以是否重復通知為檢查手段。 **支付類型** | 類型 | 說明 | 狀態 | | ------ | ---------- | ---- | | WXZF | 微信 | 支持 | | ZFBZF | 支付寶 | 支持 | | UPSMZF | 銀聯二維碼 | 支持 | | QQZF|QQ|支持| |POS| 刷卡|支持| **訂單狀態** |值|說明| |---|---| | 0 | 支付中 | | 2 | 支付成功 | | 6 | 訂單關閉 | | 8 | 支付失敗 | | 10 | 退款中 | | 11 | 退款成功 | | 12 | 退款失敗 | | 30 | 刷卡支付成功| | 31 | 刷卡撤銷成功| | 32 |刷卡退貨成功| | 33 |刷卡沖正成功|