用户签约（主动绑卡）服务

5.4 用户签约（主动绑卡）服务 5.4.1 WEB（商户(平台） 一键快捷用户前台主动关联银行卡。 商户通过用户浏览器跳转至联动支付插件，请求联动平台关联银行卡，联动关联处理完成后通知商户关联结果。通知时有两种方式，一是用户浏览器跳转的前台通知，通知的地址为请求中的ret_url值，而后台通知，由联动平台后台主动通知商户，通知的地址为请求中的notify_url值。 5.4.1.1 请求地址 http://pay.soopay.net/spay/pay/payservice.do https://pay.soopay.net/spay/pay/payservice.do 5.4.1.2 请求数据列表 NO. 字段 名称 长度 说明 必填 协议参数 10. service 接口名称 变长 32 定值：bind_req_shortcut_front Y 11. charset 参数字符编码集 变长 16 商户网站使用的编码格式，支持 UTF-8. GBK. GB2312. GB18030 Y 12. mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 13. sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 14. sign 签名 变长256 参见签名机制 Y 15. ret_url 页面跳转同步通知页面路径 变长128 交易完成后，联动优势支付平台会按照此地址将用户的交易结果页面重定向到商户网站。为保证商户能收到交易的结果，则必须至少提交ret_url，notify_url其中之一 N 16. res_format 响应数据格式 变长 16 暂支持HTML，格式见附录(默认为HTML) N 17. version 版本号 定长3 定值 4.0 Y 业务参数 23. pay_type 支付方式 变长16 取值范围： 联动CREDITCARD（信用卡） 联动DEBITCARD（借记卡） Y 24. gate_id 银行卡所属银行 变长16 详见银行列表。

Y 支付要素信息 25. mer_cust_id 商户用户标识 变长32 用户在商户端的唯一标识。 Y 26. card_id 卡号 变长 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段 N 27. media_id 媒介标识 变长 32 银行预留手机号 (media_id. media_type字段要么同时传递且有值，要么同时不传递) N 28. media_type 媒介类型 变长 16 取值范围： MOBILE（手机号） N 29. identity_type 证件类型 定长 详见 6.13证件类型ﾧ N 30. identity_code 证件号 变长 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段 N 31. card_holder 持卡人姓名 变长 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段

N 32. valid_date 信用卡有效期 （YYMM） 定长 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段 （支付方式pay_type为CREDITCARD时，选输） N 33. cvv2 信用卡CVN2/CVV2 定长 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段 （支付方式pay_type为CREDITCARD时，选输） N 34. can_modify_flag 是否允许用户修改支付要素 定长1 0：不允许修改 N

5.4.1.3 样例 请求数据样例：

平台前端通知商户ret_url签约结果数据样例：

5.4.2 WAP/HTML5（商户(平台）

一键快捷前台wap签约请求，用户主动注册。 商户通过用户手机浏览器跳转，请求联动平台完成一键支付签约，联动支付处理完成后通知商户一键支付开通结果。通知方式是用户浏览器跳转的前台通知，通知的地址为请求中的retUrl值。

5.4.2.1 请求地址 Html5：https://m.soopay.net/q/html5/protIndex.do WAP：https://m.soopay.net/q/xhtml/protIndex.do 5.4.2.2 请求数据列表 NO. 字段 名称 长度 说明 必填 签约参数 1. merId 商户号 变长 8 联动分配给商户号 Y 2. merCustId 商户用户标识 变长32 用户在商户端的唯一标识。 注册一键快捷用户业务协议； Y 3. signType 签名方式 变长 8 暂只支持RSA必须大写 Y 4. sign 商户端签名信息 变长256 参见签名机制，签名字段merId,merCustId,加签完成后使用URLEncode(UTF-8编码)加密该字段 如传递参数merId=9995，merCustId=123456，则进行签名的对象为：merId=9995&merCustId=123456，需要按照这种格式进行签名。 Y 业务参数 5. identityType 证件类型 定长 目前仅支持身份证类型IDENTITY_CARD N 6. identityCode 证件号 变长 使用联动公钥进行RSA加密后，URLEncode(UTF-8编码)加密该字段 （首次支付时选输，协议支付时不需输入） N 7. cardHolder 持卡人姓名 变长 使用联动公钥进行RSA加密后，URLEncode(UTF-8编码)加密该字段 （首次支付时选输，协议支付时不需输入） N 8. payType 支付方式 变长16 取值范围： 联动CREDITCARD（信用卡）. DEBITCARD（借记卡） N 9. gateId 支付银行 变长16 详见银行列表。 N 10. canModifyFlag 是否允许用户修改支付要素 定长1 首次支付时，如果传入identityCode. cardHolder. mobileId等支付要素，是否允许用户在联动平台上修改。 0：不允许修改 N 11. mobileId 手机号 定长11 支付时使用的手机号，11位数字格式 N 12. retUrl 页面跳转同步通知页面路径 变长128 交易完成后，联动优势支付平台会按照此地址将用户的交易结果页面重定向到商户网站。为保证商户能收到交易的结果，则必须至少提交retUrl N

5.4.2.3 样例 请求数据样例：

平台通知商户ret_url地址签约结果数据样例：

5.4.3 Android SDK（商户(平台） 请参见开发包《U付一键支付SDK1.2Android版》——《UMPAY_SW一键支付SDK_使用说明_Android版.doc》——3.1.1/3.1.2签约接口。

5.4.4 IOS SDK（商户(平台）

请参见开发包《U付一键支付SDK1.2iOS版》——《UMPAY_SW一键支付SDK_使用说明_Iphone版.doc》——3.2签约接口

5.4.5 签约绑定结果通知（平台(商户） 平台对商户的绑定求理完成后，会将处理的结果数据通过服务器主动通知的 方式通知给商户网站。这些处理结果数据就是服务器异步通知参数。 （商户方在接收联动的处理结果通知时，尽量不要使用硬编码的方式，即采用固定写法获取某些字段的值，而应采用循环遍历的方法获取联动返回的所有字段，防止联动返回的参数有变化时，例如某个字段不再返回或者多返回某个参数时，而导致商户端发生验签失败情况。） 5.4.5.1 请求地址： 商户需在下单接口中的通知url字段中上送结果通知地址。如果商户不上送该字段，则平台无法通过后台通知商户支付结果。 注：因目前前台结果通知地址可以由商户在签约接口中上送，后台结果通知地址则需要商户先发送一个地址url，由我方配置在系统中，进行后台通知商户的处理。此功能会在后续进行优化，商户可以自由上送后台通知地址。 5.4.5.2 请求数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 service 接口名称 变长 32 bind_agreement_notify_shortcut Y 2 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 3 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 4 sign 签名 变长256 参见签名机制 Y 5 version 版本号 定长3 定值 4.0 Y 业务参数 1. error_code 交易错误码 变长 32 详见附录 Y 2. media_id 媒介标识 变长 32 银行预留手机号 Y 3. media_type 媒介类型 变长 16 取值范围： MOBILE（手机号） Y 4. mer_cust_id 商户用户标识 变长32 用户在商户端的唯一标识。 Y 5. usr_busi_agreement_id 用户业务协议号 变长64 平台会为还没有注册一键快捷服务的用户注册服务，并生成此协议号。每个商户的用户标识对应唯一一个用户业务协议号。如一个用户关联多张银行卡时，会有多个支付协议号，但只有一个用户业务协议号。 Y 6. usr_pay_agreement_id 支付协议号 变长64 平台会为该用户的此银行卡注册支付协议，并生成此协议号。 Y 7. gate_id 支付银行 变长16 详见银行列表。 绑定的的银行 Y 8. last_four_cardid 银行卡卡号后四位 定长4 支付成功后的银行卡号后四位 Y

9. bank_card_type 银行卡类型 变长16 取值范围： CREDITCARD（信用卡） DEBITCARD(借记卡) Y 10. identity_type 证件类型 变长32 详见 6.10证件类型 N 11. identity_code 证件号 变长256 使用商户公钥进行RSA加密后，BASE64(GBK编码)加密该字段

N 12. card_holder 持卡人姓名 变长256 使用商户公钥进行RSA加密后，BASE64(GBK编码)加密该字段 N

5.4.5.3 响应数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 2 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 3 sign 签名 变长256 参见签名机制 Y 4 version 版本号 定长3 定值 4.0 Y 业务参数 1. ret_code 返回码 定长4 填写0000，代表通知成功 （该返回码和联动通知商户的交易是否成功无关，只要商户方成功接收到处理结果通知且验签成功，商户均应返回0000.） Y 2. ret_msg 返回信息 变长128 返回信息的描述。如果商户需要向用户下行商品信息短信，短信内容可记录在此字段 N

5.4.5.4 样例 商户请求平台示例：

平台响应商户示例：