Card Tokenization

Developing

Sandbox Env

POST

/v1/txn/bindCard

Request

Body Params application/json

appId

enum<string>

required

Application Identifier

Allowed value:

cardInfo

object

卡信息

required

Card transaction information in JSON string format

holderName

enum<string>

持卡人姓名

required

Full name of the cardholder as it appears on the payment card

<= 64 characters

Allowed value:

CL BRW2

Example:

John Smith

cardNumber

enum<string>

卡号

required

Primary account number (PAN) of the payment card without spaces or separators

<= 16 characters

Allowed values:

40000209515950324000000000002701

Example:

4000020951595032

month

enum<string>

有效期月份

required

Two-digit expiration month of the payment card (01-12)

<= 64 characters

Allowed value:

Example:

year

enum<string>

有效期年份

required

Two or four-digit expiration year of the payment card

<= 64 characters

Allowed value:

Example:

2024

cvv

enum<string>

安全码

required

Card Verification Value - security code on the back of the card (3-4 digits)

<= 64 characters

Allowed value:

123

Example:

123

country

enum<string>

required

Allowed value:

string

required

Customer Email

merchantCustId

string

required

Merchant Customer ID

merchantNo

enum<string>

required

Merchant Number

Allowed value:

sign

null

required

Signature

transactionIp

string

required

IP address of the cardholder making the transaction

Example

{
  "appId": "{{APPID}}",
  "cardInfo": {
    "holderName": "CL BRW2",
    "cardNumber": "4000000000002701",
    "month": "05",
    "year": "26",
    "cvv": "123"
  },
  "country": "US",
  "email": "Gilbert_Gerhold76@yahoo.com",
  "merchantCustId": "CustId-452O-VEFC",
  "merchantNo": "{{MERCHANT-NO}}",
  "sign": null,
  "transactionIp": "217.147.34.157"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sandbox-acq.onerway.com/v1/txn/bindCard' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "YOUR-APPLICATION-ID",
    "cardInfo": {
        "holderName": "CL BRW2",
        "cardNumber": "4000000000002701",
        "month": "05",
        "year": "26",
        "cvv": "123"
    },
    "country": "US",
    "email": "Gilbert_Gerhold76@yahoo.com",
    "merchantCustId": "CustId-452O-VEFC",
    "merchantNo": "YOUR-MERCHANT-NO",
    "sign": null,
    "transactionIp": "217.147.34.157"
}'

Responses

🟢200OK

application/json

Body

object {0}

Example

{}

Modified at 2025-03-25 05:31:17

Capture

Tokenized Payment