首次支付接口
商户前台支付请求(WEB) (商户(平台)
一键快捷前台支付请求（WEB端）。
商户通过用户浏览器跳转，请求联动平台完成支付，联动支付处理完成后通知商户支付结果。通知时有两种方式，一是用户浏览器跳转的前台post通知，通知的地址为请求中的ret_url值，而后台是get通知，由联动平台后台主动通知商户，通知的地址为请求中的notify_url值。
在本接口中，商户可以选择是否上送支付要素，如上送支付要素，平台会在支付页面展示给用户。
注： 联动优势下发验证码时间间隔为1分钟，在一分钟内，同一个商户同一个手机号只下发一次验证码，多次提交平台会返回验证码一分钟内获取多次的错误响应。验证码的失效时间是10分钟。
请求地址
http://pay.soopay.net/spay/pay/payservice.do
请求数据列表
协议参数
| NO. | 字段 | 名称 | 长度 | 说明 | 必填 |
|---|---|---|---|---|---|
| 1. | service | 接口名称 | 变长 32 | 定值：pay_req_shortcut_front | Y |
| 2. | charset | 参数字符编码集 | 变长 16 | 商户网站使用的编码格式，支持UTF-8. GBK. GB2312. GB18030 | Y |
| 3. | mer_id | 商户编号 | 变长8 | 由平台统一分配合作商户唯一标识 | Y |
| 4. | sign_type | 签名方式 | 定长 8 | 暂只支持RSA必须大写 | Y |
| 5. | sign | 签名 | 变长256 | 参见签名机制 | Y |
| 6. | ret_url | 页面跳转同步通知页面路径 | 变长128 | 交易完成后，联动优势支付平台会按照此地址将用户的交易结果页面重定向到商户网站。为保证商户能收到交易的结果，则必须至少提交ret_url，notify_url其中之一 | N |
| 7. | notify_url | 服务器异步通知页面路径 | 变长128 | 交易完成后，联动优势支付平台会按照此地址将交易结果以后台的方式发送到商户网站因前端响应受用户操作及网络波动因素较大，所以需要以后台结果通知地址接受订单支付结果。 | Y |
| 8. | res_format | 响应数据格式 | 变长 16 | 暂支持HTML，格式见附录(默认为HTML) | N |
| 9. | version | 版本号 | 定长3 | 定值 4.0 | Y |
业务参数
| NO. | 字段 | 名称 | 长度 | 说明 | 必填 |
|---|---|---|---|---|---|
| 1. | goods_id | 商品号 | 变长8 | 支持数字，字母该参数为唯一一个对账文件返回的商户保留字段 | N |
| 2. | goods_inf | 商品描述信息 | 变长64 | 如果传递中文，需确保该字段在传入接口前，编码正确，建议使用UTF-8编码（根据商户服务器编码环境而定）。 | N |
| 3. | order_id | 商户唯一订单号 | 变长32 | 订单号码支持数字. 英文字母. -. _. *. +. #，其他字符将不支持，不能小于4位。 | Y |
| 4. | mer_date | 商户订单日期 | 定长8 | 商户生成订单的日期，格式YYYYMMDD | Y |
| 5. | amount | 付款金额 | 变长13 | 如果是人民币，则以分为单位 | Y |
| 6. | amt_type | 付款币种 | 变长 8 | 取值范围：RMB | Y |
| 7. | pay_type | 支付方式 | 变长16 | 取值范围：CREDITCARD（信用卡）DEBITCARD(借记卡) | Y |
| 8. | gate_id | 支付银行 | 变长16 | 详见银行列表。银行列表需要商户维护。 | Y |
| 9. | mer_priv | 商户私有域 | 变长128 | 联动优势支付平台原样返回，用于商户的私有信息。 | N |
| 10. | user_ip | 用户IP地址 | 变长 16 | 用户在创建交易时，该用户当前所使用机器的 IP。用作防钓鱼校验 | N |
| 11. | expand | 业务扩展信息 | 变长128 | 主要保存扩展字段的信息,详见附录 | N |
| 12. | expire_time | 订单过期时长 | 变长 8 | 单位为分钟，默认1440分钟（24小时） | N |
| 13. | mer_cust_id | 商户用户标识 | 变长32 | 用户在商户端的唯一标识。首次支付时：如果输入该值，且用户在联动的收银台上同意一键快捷服务协议，则会注册一键快捷用户业务协议；如果没有输入，平台不会注册用户业务协议，也不会返回相应的注册签约信息，用户再次进行支付时，则还需要走首次支付。 | N |
| 14. | card_id | 卡号 | 变长 | 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段 | N |
| 15. | media_id | 媒介标识 | 变长 32 | 银行预留手机号(media_id. media_type字段要么同时传递且有值，要么同时不传递) | N |
| 16. | media_type | 媒介类型 | 变长 16 | 取值范围：MOBILE（手机号）(media_id. media_type字段要么同时传递且有值，要么同时不传递) | N |
| 17. | identity_type | 证件类型 | 变长32 | 详见 6.10证件类型 | N |
| 18. | identity_code | 证件号 | 变长256 | 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段 | N |
| 19. | card_holder | 持卡人姓名 | 变长256 | 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段 | N |
| 20. | valid_date | 信用卡有效期（YYMM） | 变长256 | 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段（支付方式pay_type为CREDITCARD时，选输） | N |
| 21. | cvv2 | 信用卡CVN2/CVV2 | 变长256 | 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段（支付方式pay_type为CREDITCARD时，选输） | N |
| 22. | can_modify_flag | 是否允许用户修改支付要素 | 定长1 | 首次支付时，如果传入card_id. card_holder等支付要素，是否允许用户在联动平台上修改。0：不允许修改不传值：允许修改 | N |
注：针14-21几个支付要素的说明：
如果商户端在本接口中传输这几个参数，则在用户跳转到平台支付页面后，平台会展示给用户。
样例
请求数据样例：
商户前台支付请求(wap/html5) (商户(平台)
一键支付快捷wap/html5引导链接前台确认支付请求，首次支付。 商户通过用户手机浏览器跳转，请求联动平台完成支付，联动支付处理完成后通知商户支付结果。通知时有两种方式，一是用户浏览器跳转的前台通知，通知的地址为请求中的ret_url值，而是后台通知，由联动平台后台主动通知商户，通知的地址为请求中的notify_url值。 调用本接口前，需调用5.2 商户API下单接口，进行订单预处理操作，获取trade_no参数。
请求地址
wap引导链接请求地址：https://m.soopay.net/q/xhtml/index.do?
Html5引导链接请求地址：https://m.soopay.net/q/html5/index.do?
请求数据列表
支付参数
| NO. | 字段 | 名称 | 长度 | 说明 | 必填 |
|---|---|---|---|---|---|
| 1. | tradeNo | 联动交易号 | 变长 16 | 商户下单成功后返回交易号商户调用api下单接口，获取响应内容中的trade_no参数。 | Y |
业务参数
| NO. | 字段 | 名称 | 长度 | 说明 | 必填 |
|---|---|---|---|---|---|
| 1. | identityType | 证件类型 | 定长 | 目前仅支持身份证类型IDENTITY_CARD | N |
| 2. | identityCode | 证件号 | 变长 | 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段 | N |
| 3. | cardHolder | 持卡人姓名 | 变长 | 使用联动公钥进行RSA加密后，BASE64(GBK编码)加密该字段 | N |
| 4. | merCustId | 商户用户标识 | 变长32 | 用户在商户端的唯一标识。首次支付时：如果输入该值，且用户在联动的收银台上同意一键快捷服务协议，则会注册一键快捷用户业务协议；如果没有输入，平台不会注册用户业务协议，也不会返回相应的注册签约信息，用户再次进行支付时，则还需要走首次支付。 | N |
| 5. | payType | 支付方式 | 变长16 | 取值范围：CREDITCARD（信用卡）. DEBITCARD（借记卡） | N |
| 6. | gateId | 支付银行 | 变长16 | 详见银行列表。 | N |
| 7. | canModifyFlag | 是否允许用户修改支付要素 | 定长1 | 首次支付时，如果传入identityCode.cardHolder. mobileId等支付要素，是否允许用户在联动平台上修改。0：不允许修改 | N |
| 8. | mobileId | 手机号 | 定长11 | 支付时使用的手机号，11位数字格式 | N |
样例
请求数据样例：
商户前台支付请求（SDK-android） (商户(平台)
调用本接口前，需调用5.2 商户API下单接口，进行订单预处理操作，获取tradeno参数。 SDK中的开发请参见开发包《U付一键支付SDK1.2_Android版》——《UMPAY_SW一键支付SDK_使用说明_Android版.doc》——3.1支付接口。
商户前台支付请求（SDK- IOS） (商户(平台)
调用本接口前，需调用5.2 商户API下单接口，进行订单预处理操作，获取tradeno参数。 SDK中的开发请参见开发包《U付一键支付SDK1.2_iOS版》——《UMPAY_SW一键支付SDK_使用说明_Iphone版.doc》——3.1支付接口。