扣款成功后,平台向商户通知扣款结果。前台响应商户请求结果,后台异步通知商户扣款结果,且商户需要同步给联动平台支付结果通知响应,具体响应数据请参考下面的响应数据列表。(商户方在接收联动的支付结果通知时,尽量不要使用硬编码的方式,即采用固定写法获取某些字段的值,而应采用循环遍历的方法获取联动返回的所有字段,防止联动返回的参数有变化时,例如某个字段不再返回或者多返回某个参数时,而导致商户端发生验签失败情况)。
通知地址为下单请求中传递给平台的notify_url地址。
由于后台结果通知对平台与商户的网络通讯影响很小,请商户根据平台后台结果通知来获得用户订单状态,并进行后续相关操作。
商户需在下单接口中的notify_url字段中上送结果通知地址。如果商户不上送该字段,则平台无法通过后台通知商户支付结果。
[平台到商户请求数据]
协议参数
NO. | 字段 | 名称 | 长度 | 说明 | 必填 |
---|---|---|---|---|---|
1 | service | 接口名称 | 变长 32 | pay_result_notify | Y |
2 | mer_id | 商户编号 | 变长8 | 由平台统一分配合作商户唯一标识 | Y |
3 | sign_type | 签名方式 | 定长 8 | 暂只支持RSA必须大写 | Y |
4 | sign | 签名 | 变长256 | 参见签名机制 | Y |
5 | version | 版本号 | 定长3 | 定值 4.0 | Y |
业务参数
NO. | 字段 | 名称 | 长度 | 说明 | 必填 |
---|---|---|---|---|---|
1. | trade_no | 联动交易号 | 变长 16 | Y | |
2. | goods_id | 商品号 | 变长8 | 商户下单时提交的goods_id | N |
3. | order_id | 订单号 | 变长32 | 商户下单时提交的order_id | Y |
4. | mer_date | 商户订单日期 | 定长8 | 商户下单时提交的mer_date | Y |
5. | pay_date | 支付日期 | 定长8 | 用户对订单进行支付的日期,格式是YYYYMMDD | Y |
6. | amount | 付款金额 | 变长13 | 如果是人民币,则以分为单位 | Y |
7. | amt_type | 付款币种 | 变长8 | 取值范围:RMB | Y |
8. | pay_type | 支付方式 | 变长16 | 取值范围:B2BBANK(B2B网银)B2CBANK(B2C网银)SOOPAY(U付账户)MOBILEBANKCARD(手机银行卡)CREDITCARD(信用卡)DEBITCARD(借记卡) | Y |
9. | media_id | 媒介标识 | 变长 32 | 支付使用的手机号 | N |
10. | media_type | 媒介类型 | 变长16 | 取值范围:MOBILE(手机号)EMAIL(邮箱地址) | N |
11. | settle_date | 对账日期 | 定长8 | 商户的对账报表和对账报表均以此日期为准,格式为YYYYMMDD | Y |
12. | mer_priv | 商户私有域 | 变长128 | 支付平台按商户请求数据原样返回 | N |
13. | trade_state | 交易状态 | 变长 8 | 详见说明见6.7交易状态 | Y |
14. | pay_seq | 银行流水 | 变长 | N | |
15. | error_code | 交易错误码 | 变长 32 | 详见附录 | N |
16. | usr_busi_agreement_id | 用户业务协议号 | 变长64 | 用户支付成功,并且请求时mer_cust_id字段有值,平台会为还没有注册一键快捷服务的用户注册服务,并生成此协议号。每个商户的用户标识对应唯一一个用户业务协议号。如一个用户关联多张银行卡时,会有多个支付协议号,但只有一个用户业务协议号。如下单未传递商户用户标识,则未绑定一键支付协议,平台不返回此参数。 | N |
17. | usr_pay_agreement_id | 支付协议号 | 变长64 | 用户注册一键快捷服务后,并选择某个银行卡首次支付成功时,平台会为该用户的此银行卡注册支付协议,并生成此协议号。该值不为空时表明是首次支付,并且关联银行卡成功。可根据该值来判断是否关联成功。如下单未传递商户用户标识,则未绑定一键支付协议,平台不返回此参数。 | N |
18. | gate_id | 支付银行 | 变长16 | 详见银行列表。支付成功后的银行 | N |
19. | last_four_cardid | 银行卡卡号后四位 | 定长4 | 支付成功后的银行卡号后四位 | N |
20. | identity_type | 证件类型 | 变长32 | 详见 6.10证件类型 | N |
21. | identity_code | 证件号 | 变长256 | 使用商户公钥进行RSA加密后,BASE64(GBK编码)加密该字段 | N |
22. | card_holder | 持卡人姓名 | 变长256 | 使用商户公钥进行RSA加密后,BASE64(GBK编码)加密该字段 | N |
[商户给平台响应数据]
协议参数
NO. | 字段 | 名称 | 长度 | 说明 | 必填 |
---|---|---|---|---|---|
1 | mer_id | 商户编号 | 变长8 | 由平台统一分配合作商户唯一标识 | Y |
2 | sign_type | 签名方式 | 定长 8 | 暂只支持RSA必须大写 | Y |
3 | sign | 签名 | 变长256 | 参见签名机制 | Y |
4 | version | 版本号 | 定长3 | 定值 4.0 | Y |
业务参数
NO. | 字段 | 名称 | 长度 | 说明 | 必填 |
---|---|---|---|---|---|
1. | order_id | 商户唯一订单号 | 变长32 | 商户下单时订单号 | Y |
2. | mer_date | 商户订单日期 | 定长8 | 商户下单时订单日期 | Y |
3. | ret_code | 返回码 | 定长4 | 填写0000,代表通知成功(该返回码和联动通知商户的交易是否成功无关,只要商户方成功接收到支付结果通知且验签成功,商户均应返回0000.) | Y |
4. | ret_msg | 返回信息 | 变长128 | 返回信息的描述。如果商户需要向用户下行商品信息短信,短信内容可记录在此字段 | N |
5. | mer_check_date | 商户对账日期 | 定长 8 | N | |
6. | mer_trace | 商户处理流水 | 变长 32 | N |
平台请求商户示例:
商户响应平台示例: