## **刷卡交易通知** ## **注**：通知 URL 與掃碼支付成功通知一樣，均為代理商后臺配置的通知地址。刷卡交易成功時、刷卡撤銷成功時、刷卡退貨成功時、刷卡沖正成功時，樂刷均會把相關交易信息發送到該 URL，商戶需要接收處理信息。對后臺通知交互時，如果收到商戶的應答不是成功或者超時，樂刷認為通知失敗，會通過一定的策略定期重新發起通知，盡可能的提高通知的成功率，但是不保證通知最終一定能成功。由于存在重復發送后臺通知的情況，因此同樣的通知可能會多次發送給商戶系統。系統必須能夠正確處理重復的通知。 - 驗證簽名方法：通知的 error\_code、sign 字段不參與簽名，簽名方式參照第 3 章 數據簽名，其中簽名 key 統一由樂刷提供。另外，組織簽名串時空值也參與簽名。 **通知參數** | 字段名 | 變量名| 必填 | 長度限制 | 類型 | 說明 | | ---------- | ------------------ | ---- | -------- | ------ | ----------------------------- | |簽名|sign|是|32|string|MD5 簽名結果| |訂單狀態|status|是|無|string|[詳見下方訂單狀態](#訂單狀態)| |失敗原因|failure_reason|否|無|string|失敗原因| |商戶號|merchant_id|是|10|string|由樂刷分配| |商戶訂單號|third_order_id|是|64|string|商戶內部訂單號| |樂刷訂單號|leshua_order_id|是|32|string|樂刷訂單號| |交易金額|amount|是|無|string|交易金額（分）| |銀行卡號|card_id|否|無|string|刷卡交易時提供| |卡類型|card_type|否|1|string|刷卡交易時提供0 未知；1 借記卡；2 貸記卡；3 準貸記賬戶；4 借貸合一賬戶；5 預付費賬戶；6 半開放預付費賬戶| |發卡行|bank_name|否|無|string|刷卡交易時提供| |刷卡pos批次號|batch_no|是|無|string|| |刷卡pos流水號|flow_id|是|3|string|| |刷卡pos參考號|reference_number|是|32|string|| |刷卡交易時間|pay_time|否|無|string|刷卡交易時提供| |消費撤銷時間|refund_time|否|無|string|消費撤銷時提供| |消費退貨時間|returngoods_time|否|無|string|消費退貨時提供| |消費沖正時間|reverse_time|否|無|string|消費沖正時提供| |商戶撤銷id|merchant_refund_id|否|無|string|消費撤銷時提供| |商戶退貨id|merchant_returngoods_id|否|無|string|消費退貨時提供| |樂刷退款id|leshua_refund_id|否|18|string|消費退貨時提供| |商戶沖正id|merchant_reverse_id|否|無|string|消費沖正時提供| **返回參數** | 字段名 | 變量名| | ---------- | ------------------ | |000000|通知成功，樂刷收到此返回后不會繼續通知| |其他|樂刷收到回復或者未收到回復，系統會再次通知| **訂單狀態** |值|說明| |---|---| | 0 | 支付中 | | 2 | 支付成功 | | 6 | 訂單關閉 | | 8 | 支付失敗 | | 10 | 退款中 | | 11 | 退款成功 | | 12 | 退款失敗 | | 30 | 刷卡支付成功| | 31 | 刷卡撤銷成功| | 32 |刷卡退貨成功| | 33 |刷卡沖正成功| |41|預授權成功| |43|預授權撤銷成功| |45|預授權完成（請求）成功| |47|預授權完成（通知）成功| |49|預授權完成撤銷成功|