U付

交易结果通知(平台商户)

扣款成功后,平台向商户通知扣款结果。前台响应商户请求结果,后台异步通知商户扣款结果,且商户需要同步给联动平台支付结果通知响应,具体响应数据请参考下面的响应数据列表。(商户方在接收联动的支付结果通知时,尽量不要使用硬编码的方式,即采用固定写法获取某些字段的值,而应采用循环遍历的方法获取联动返回的所有字段,防止联动返回的参数有变化时,例如某个字段不再返回或者多返回某个参数时,而导致商户端发生验签失败情况)。

通知地址为下单请求中传递给平台的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

样例

平台请求商户示例:

商户响应平台示例: