## **掃碼退款通知** ## **注**:通知 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|樂刷訂單號| |退款金額|refund_amount|是|無|string|退款金額（分）| |商戶退款 id|merchant_refund_id|是|64|string|| |樂刷退款 id|leshua_refund_id|是|32|string|| |訂單總金額|total_amount|是|無|string|| |退款時間|refund_time|否|無|string|退款成功時間-退款成功才返回| **返回參數** | 字段名 | 變量名| | ---------- | ------------------ | |000000|通知成功，樂刷收到此返回后不會繼續通知| |其他|樂刷收到回復或者未收到回復，系統會再次通知| **訂單狀態** |值|說明| |---|---| | 0 | 支付中 | | 2 | 支付成功 | | 6 | 訂單關閉 | | 8 | 支付失敗 | | 10 | 退款中 | | 11 | 退款成功 | | 12 | 退款失敗 | | 30 | 刷卡支付成功| | 31 | 刷卡撤銷成功| | 32 |刷卡退貨成功| | 33 |刷卡沖正成功|