绑卡支付
两方支付商户必须提供 PCI DSS(支付卡行业数据安全标准)
请求参数
POST
| 名称 | 类型 | 长度 | 必填 | 签名 | 描述 |
|---|---|---|---|---|---|
| merchantNo | String | 20 | Yes | Yes | 商户号。 商户注册时,OnerWay会为商户创建商户号 |
| appId | String | 20 | Yes | Yes | 商户应用程序 ID。 商户注册网站时,OnerWay会为商户创建一个应用id |
| merchantCustId | String | 50 | Yes | Yes | 客户在商户的唯一标识 |
| cardInfo | String | / | Yes | Yes | 交易卡信息。 格式为 json 字符串。 请参阅对象 |
| String | 256 | Yes | Yes | 商户客户的邮箱 | |
| country | String | 64 | Yes | Yes | 商户客户的国家。请参考 ISO 3166。 |
| transactionIp | String | 64 | Yes | Yes | 商户客户的交易IP |
| sign | String | / | Yes | No | 签名字符串,请参阅签名接口 |
CardInfo
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| holderName | String | 48 | Yes | 持卡人姓名 |
| cardNumber | String | 128 | Yes | 持卡人卡号 |
| month | String | 64 | Yes | 卡号月份 |
| year | String | 64 | Yes | 卡号年份 |
| cvv | String | 64 | Yes | 卡号cvv |
响应参数
| 名称 | 类型 | 签名 | 描述 |
|---|---|---|---|
| respCode | String | No | 来自 Onerway 的响应码 |
| respMsg | String | No | 来自 Onerway 的响应信息 |
| data | Object | No | 响应数据。 请参阅对象 token 信息,subProductType为TOKEN或AUTO_DEBIT时必填,格式为json字符串。 请参阅对象TokenInfo |
TokenInfo
| 名称 | 类型 | 签名 | 描述 |
|---|---|---|---|
| transactionId | String | Yes | Onerway 创建的交易订单号 |
| tokenId | String | Yes | 绑卡令牌id |
| status | String | Yes | 绑卡状态。S表示绑卡成功,F表示绑卡失败 |
| sign | String | No | 签名字符串,请参阅签名接口 |
绑卡支付请求响应示例
POST
json
{
"appId": "1831944691027152896",
"cardInfo": "{\"cardNumber\":\"4000020951595032\",\"cvv\":\"123\",\"month\":\"12\",\"year\":\"2031\",\"holderName\":\"CL BRW2\"}",
"country": "US",
"email": "abel.wang@onerway.com",
"merchantCustId": "custId_27.17.250.216",
"merchantNo": "800209",
"sign": "5102d2ff9ad1587065e45f5659d256d21f92151df2a5269121c898268beb3f70",
"transactionIp": "127.0.0.1"
}1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
json
{
"respCode": "20000",
"respMsg": "Success",
"data": {
"transactionId": "1851503871508484096",
"tokenId": "fac178413aabfd535e9c30b2b82db4b47af29d70425350552afe32e1aff6a9e4",
"status": "S", // S表示绑卡成功
"sign": "332ac88972a6e753d069a2b006200c68c6326e371cc3614e71f520ac7f9fffc3"
}
}1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
注意
- 请保存回调里的
tokenId和contractId以便后续调用 Token支付进行免卡号支付