绑卡支付
两方支付商户必须提供 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支付进行免卡号支付