U付

商户API下单 (商户平台)

5.2 商户API下单 (商户(平台) 一键支付快捷后台api下单接口。 商户系统通过后台API接口下单,以便联动进行支付前的预处理。 本接口本接口获取的trade_no参数适用于: 5.1.2 商户前台支付请求(wap/html5) 5.1.3 商户前台支付请求(SDK-android) 5.1.4 商户前台支付请求(SDK-IOS) 5.3.1商户获取短信验证码 5.3.2 商户API确认支付

5.2.1 请求地址: http://pay.soopay.net/spay/pay/payservice.doᄃ

5.2.2 请求数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1. service 接口名称 变长 32 定值:payreq_shortcut 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. notify_url 服务器异步通知页面路径 变长128 交易完成后,联动优势支付平台会按照此地址将交易结果以后台的方式发送到商户网站 N 7. res_formatᄃ 响应数据格式 变长 16 暂支持HTML,格式见附录(默认为HTML) N 8. version 版本号 定长3 定值 4.0 Y 业务参数 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. mer_priv 商户私有域 变长128 联动优势支付平台原样返回,用于商户的私有信息。 N 8. expand 业务扩展信息 变长128 主要保存扩展字段的信息,详见附录ᄃ N 9. expire_time 订单过期时长 变长 8 单位为分钟,默认1440分钟(24小时) N

5.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. trade_no 联动交易号 变长 16 对于商户的每次非重复下单,联动都会生成一个唯一交易号。 N 2. trade_state 交易状态 变长 32 详见说明见6.7交易状态 N 3. ret_code 返回码 定长 4 详见附录 Y 4. ret_msg 返回信息 变长128

N

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

平台响应商户示例: