U付

查询关联服务

5.6 查询关联服务 5.6.1 查询商户支持的银行列表(商户(平台) 商户请求联动平台,获取可以使用的银行列表。并在商户的收银台上展示,供用户选择。 5.6.1.1 请求地址: http://pay.soopay.net/spay/pay/payservice.doᄃ 5.6.1.2 请求数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 service 接口名称 变长 32 query_mer_bank_shortcut Y 2 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 3 charset 参数字符编码集 变长 16 商户网站使用的编码格式,支持 UTF-8. GBK. GB2312. GB18030 Y 4 sign 签名 变长256 参见签名机制 Y 5 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 6 version 版本号 定长3 定值 4.0 Y 7 res_format 响应数据格式 变长 16 暂支持HTML,格式见附录(默认为HTML) N 业务参数 1 pay_type 支付方式 变长16 信用卡:CREDITCARD 借记卡:DEBITCARD Y

5.6.1.3 响应数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 2 sign 签名 变长256 参见签名机制 Y 3 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 4 version 版本号 定长3 定值 4.0 Y 业务参数 1. ret_code 返回码 定长4 详见附录 Y 2. ret_msg 返回信息 变长128

N 3. mer_bank_list 商户银行列表信息 变长 银行与银行之间用竖线“|”分割。 如工商信用卡与建行信用卡表示如: ICBC |CCB N

5.6.1.4 样例 商户请求平台示例:

平台响应商户示例:

5.6.2 查询商户用户已签约的银行列表(商户(平台) 商户请求联动平台,获取用户已经签约一键快捷的银行列表。 5.6.2.1 请求地址: http://pay.soopay.net/spay/pay/payservice.doᄃ

5.6.2.2 请求数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 service 接口名称 变长 32 query_mercust_bank_shortcut Y 2 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 3 charset 参数字符编码集 变长 16 商户网站使用的编码格式,支持 UTF-8. GBK. GB2312. GB18030 Y 4 sign 签名 变长256 参见签名机制 Y 5 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 6 version 版本号 定长3 定值 4.0 Y 7 res_formatᄃ 响应数据格式 变长 16 暂支持HTML,格式见附录(默认为HTML) N 业务参数 1. pay_type 支付方式 变长16 信用卡:CREDITCARD 借记卡:DEBITCARD Y 2. mer_cust_id 商户用户标识 变长64 用户在商户端的唯一标识。

二者必传其一,如果两者都传,平台会校验是否一致 3. usr_busi_agreement_id 用户业务协议号 变长64 用户注册一键快捷服务时在联动生成的协议号,每个商户的用户标识在平台对应唯一一个业务协议号。

5.6.2.3 响应数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 2 sign 签名 变长256 参见签名机制 Y 3 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 4 version 版本号 定长3 定值 4.0 Y 业务参数 1 ret_code 返回码 定长4 详见附录 Y 2 ret_msg 返回信息 变长128

N 3 user_bank_list 用户银行列表信息 变长 银行与银行之间用竖线“|”分割,每个银行包含的数据有:银行编码(见银行列表). 支付协议号. 卡号后四位,手机号。字段之间用英文半角逗号“,”分割。 如工商某信用卡与建行某信用卡表示如: ICBC,xxxxxxxxxxxxxxxxx,0922,1520111110|CCB,ssssssssssssssssss,3242, 1520111110 N 5.6.2.4 样例 商户请求平台示例:

平台响应商户示例: