## **扫码支付成功通知** ## **注**：通知 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 |刷卡冲正成功|