## **刷卡交易通知** ## **注**：通知 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|预授权完成撤销成功|