协议支付接口
商户获取短信验证码(商户(平台)
商户可以请求平台为用户下发短信验证码。协议支付时不必传入支付要素。 如商户明确要求不需要联动下发短信验证码且经过联动同意后，可以不调用本接口。 注： 联动优势下发验证码时间间隔为1分钟，在一分钟内，同一个商户同一个手机号只下发一次验证码，多次提交平台会返回验证码一分钟内获取多次的错误响应。验证码的失效时间是10分钟。
请求地址：
http://pay.soopay.net/spay/pay/payservice.doﾧ
请求数据列表
[平台到商户请求数据]
协议参数
| NO. | 字段 | 名称 | 长度 | 说明 | 必填 |
|---|---|---|---|---|---|
| 1 | service | 接口名称 | 变长 32 | req_smsverify_shortcut | 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. | mer_cust_id | 商户用户标识 | 变长32 | 用户在商户端的唯一标识。 | 协议支付时二者必填其一 |
| 3. | usr_busi_agreement_id | 用户业务协议号 | 变长64 | 用户注册一键快捷服务时在联动生成的协议号，每个商户的用户标识在平台对应唯一一个用户业务协议号。 | |
| 4. | usr_pay_agreement_id | 支付协议号 | 变长64 | 用户一键快捷注册成功后，会为每一个首次支付成功的银行卡注册支付协议。平台根据支付协议号查找注册时的手机，并给该手机下发短信验证码。使用协议支付时该值必填。 | Y |
响应数据列表
协议参数
| NO. | 字段 | 名称 | 长度 | 说明 | 必填 |
|---|---|---|---|---|---|
| 1 | sign_type | 签名方式 | 定长 8 | 暂只支持RSA必须大写 | Y |
| 2 | sign | 签名 | 变长256 | 参见签名机制 | Y |
| 3 | mer_id | 商户编号 | 变长8 | 由平台统一分配合作商户唯一标识 | Y |
| 4 | version | 版本号 | 定长3 | 定值 4.0 | Y |
业务参数
| NO. | 字段 | 名称 | 长度 | 说明 | 必填 |
|---|---|---|---|---|---|
| 1 | ret_code | 返回码 | 变长8 | 0000: 下发短信成功 00080706: 一分钟内获取多次 00080709：同一订单验证码错误次数超过最大限制，不允许再下发 00080707: 订单获取短信验证码次数超限 00060920: 支付要素验证不通过 非0000均代表下发短信失败 | Y |
| 2 | ret_msg | 返回信息 | 变长128 | N |
样例：
请求数据样例：
响应数据样例：
商户API确认支付（商户(平台）
一键支付快捷后台api支付确认接口。 商户调用api下单接口获取trade_no和调用获取短信验证码接口获取短信验证码后，收集用户的支付要素信息. 验证码，U付订单号trade_no，调用本接口请求平台进行订单支付。 如商户明确要求不需要联动下发短信验证码且经过联动同意后，可以在本接口中，不传递验证码参数，平台不会校验。
请求地址：
http://pay.soopay.net/spay/pay/payservice.doﾧ
请求数据列表
[平台到商户请求数据] NO. 字段 名称 长度 说明 必填 协议参数 1. service 接口名称 变长 32 agreement_pay_confirm_shortcut Y 2. mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 3. charset 参数字符编码集 变长 16 商户网站使用的编码格式，支持 UTF-8. GBK. GB2312. GB18030 Y 4. res_formatﾧ 响应数据格式 变长 16 暂支持HTML，格式见附录(默认为HTML) N 5. sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 6. sign 签名 变长256 参见签名机制 Y 7. version 版本号 定长3 定值 4.0 Y 业务参数 1. trade_no 联动交易号 变长 16 商户下单时返回给商户的联动交易号 Y 2. verify_code 验证码 变长8 联动平台给用户下发的短信验证码。如果商户线下明确要求不用联动下发验证码的，可以不传该值。 N 3. mer_cust_id 商户用户标识 变长32 用户在商户端的唯一标识。 协议支付时：如果用户已经注册一键快捷业务协议，平台会根据该值查找用户业务协议，提供一键快捷服务。 N（协议支付时商户用户标识. 用户业务协议号必传其一） 4. usr_busi_agreement_id 用户业务协议号 变长64 用户注册一键快捷服务时在联动生成的协议号，每个商户的用户标识在平台对应唯一一个用户业务协议号。平台会根据该值提供一键快捷服务。
5. usr_pay_agreement_id 支付协议号 变长64 用户一键快捷注册成功后，会为每一个首次支付成功的银行卡注册支付协议。指定支付协议号，平台就能为用户提供相应的银行卡支付服务。 协议支付时该值必填。 Y 6. birthday 用户出生日期 定长8 商户上送此用户出生日期时，会与用户之前注册支付协议时绑定身份证进行对比，不一致则返回异常 格式:YYYYMMDD 使用借记卡协议支付式选填N 7. valid_date 信用卡有效期 （YYMM） 变长256 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段 N 8. cvv2 信用卡CVN2/CVV2 变长256 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段 N 5.3.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. order_id 订单号 变长32 商户下单时提交的order_id Y 2. mer_date 商户订单日期 定长8 商户下单时提交的mer_date Y 3. pay_date 支付日期 定长8 用户对订单进行支付的日期，格式是YYYYMMDD Y 4. amount 付款金额 变长13 如果是人民币，则以分为单位 Y 5. amt_type 付款币种 变长8 取值范围： RMB Y 6. settle_date 对账日期 定长8 联动同商户的对账日期，格式为YYYYMMDD 扣款成功时，此字段必有值 N 7. mer_priv 商户私有域 变长128 支付平台按商户请求数据原样返回 N 8. trade_state 交易状态 变长 8 详见说明见6.7交易状态 Y 9. ret_code 返回码 定长4 详见附录 Y 10. ret_msg 返回信息 变长128
N
样例
请求数据样例：
响应数据样例：
