## **扫码退款通知** ## **注**:通知 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 |刷卡冲正成功|