托管页支付服务
支付步骤
- 商户发起交易请求，使用 https 协议，通过浏览器重定向到支付系统。
- 支付系统处理交易请求，并提交到银行进行消费/预授权交易。
- 交易完成后，支付系统把支付结果相关参数重定向到网店支付结果页面。
- 在支付结果页面获取支付结果，修改网店订单状态并把支付结果显示到页面以便提示持卡人该笔订单交易结果。
发送数据
参数列表如下：(浏览器重定向)
| 参数名 | 类型 | 最大长度 | 是否必填 | 描述 |
|---|---|---|---|---|
| 商户信息 | ||||
| merNo | String | 5 | Yes | 【商户号】 |
| gatewayNo | String | 8 | Yes | 【网关接入号】 |
| orderNo | String | 50 | Yes | 【商户订单号】 |
| orderAmount | String | 10 | Yes | 【交易总金额】 包括订单的其他所有金额之和. 只能为数字，并且只限小数点后2位小数. |
| orderCurrency | String | 3 | Yes | 【交易币种】 币种简称.具体详见附录: 交易币种（ISO 4217） |
| signInfo | String | 64 | Yes | 【签名数据】明文加密结构: merNo + gatewayNo + orderNo + orderCurrency+ orderAmount + returnUrl+ signkey; 返回数据为大写,各语言加密方式不同. 具体详见附录: sha256签名方式 |
| returnUrl | String | 500 | Yes | 【实时返回地址】 用来返回交易结果信息到商户网店。 |
| notifyUrl | String | 500 | NO | 【异步返回地址】 用来返回交易结果信息到商户网店。 |
| firstName | String | 100 | Yes | 【客人的名】 |
| lastName | String | 50 | Yes | 【客人的姓】 |
| String | 200 | Yes | 【客人的邮件】 | |
| phone | String | 50 | Yes | 【客人的联系电话】 |
| shipFee | String | 100 | No | 【运费】 只能为数字,并且只限小数点后2位小数. |
| discount | String | 100 | No | 【折扣】 折扣默认为负值 只能为数字,并且只限小数点后2位小数. |
| goodsInfo | String | 5000 | Yes | 【货物详细信息】 包括货物名称，ID，单价，数量具体详见附录：货物信息 |
| country | String | 100 | Yes | 【客人的账单国家】简称. 如美国：US |
| state | String | 100 | Yes | 【客人的所在州】全称. |
| city | String | 100 | Yes | 【客人的账单城市】全称. |
| address | String | 500 | Yes | 【客人的账单地址】 |
| zip | String | 100 | Yes | 【客人的邮编】 |
| 收货信息(可选) | ||||
| shipFirstName | String | 100 | No | 【收货人姓】 |
| shipLastName | String | 100 | No | 【收货人名】 |
| shipEmail | String | 100 | No | 【收货人邮箱】 |
| shipPhone | String | 100 | No | 【收货人电话】 |
| shipCountry | String | 100 | No | 【收货人国家】简称. 如美国：US |
| shipState | String | 100 | No | 【收货人省份】全称. |
| shipCity | String | 100 | No | 【收货人城市】全称. |
| shipAddress | String | 500 | No | 【收货人详细地址】 |
| shipZip | String | 100 | No | 【收货人邮编】 |
| 其他 | ||||
| remark | String | 1000 | No | 【备注】可作为扩展信息. |
返回数据
支付完成后，系统把支付结果重定向到返回地址(包括 POST 和 GET 两种方式返回)，所以返回页面必须确保两种支付返回方式都能接收。其中：默认先浏览器返回，后服务器 POST 返回。
| Name | Type | Description |
|---|---|---|
| merNo | String | 【商户号】 |
| gatewayNo | String | 【网关接入号】 |
| tradeNo | String | 【交易流水订单号】 |
| orderNo | String | 【商户订单号】 |
| orderCurrency | String | 【交易币种】 |
| orderAmount | String | 【交易金额】 |
| orderStatus | String | 【交易状态】 返回数字：-2/-1/0/1 -2: 待确认 -1: 待处理 0: 失败 1: 成功 |
| orderInfo | String | 【交易结果信息】 Code+具体信息。 |
| billAddress | String | 【账单地址】 支付成功返回交易的账单地址。支付失败则返回空值。 |
| signInfo | String | 【数据签名(大写)】 signInfo=sha256(merNo + gatewayNo + tradeNo + orderNo + orderCurrency + orderAmount + orderStatus + orderInfo + signkey); |
| paymentMethod | String | 支付方式，信用卡:Credit Card |
| orderErrorCode | String | 支付失败返回码 |
| returnType | String | 1: 浏览器实时返回 2：服务器实时返回 3：服务器异步返回 |
| Remark | String | 【备注】 发送数据的时候，传输的什么，就返回什么。 |