Create a card

Request

Body Params application/json

request_id

string

optional

Unique identifier

<= 100 characters

connector_bin_id

number

required

Connector BIN ID

cardholder_id

number

required

Cardholder ID

group_id

number

required

Group ID

charge_amount

string

required

Recharge amount; Value can be digits only. Please refer to ISO 4217 for decimal values of each currency

<= 12 characters

card_alias

string

required

Card alias

<= 100 characters

pieces

number

required

Quantity

start_date

string

required

Card start date (YYYY-MM-DD)

<= 10 characters

end_date

string

required

Card end date (YYYY-MM-DD)

<= 10 characters

enable_currency_check

string

required

Whether currency check during card creation (true, false)

<= 10 characters

enable_shared

string

required

Whether the card can be shared (true, false)

<= 10 characters

enable_multi_use

string

required

Whether the card can be used multiple times (true, false)

<= 10 characters

company_id

number

required

Merchant Code or Merchant ID or Merchant Number

sign

string

required

Digital signatures information
Encryption Rule: touppercase(SHA256(company_id + connector_bin_id + cardholder_id + charge_amount + api_key))
All encryption parameters need to remove spaces before encryption.

<= 100 characters

Example

{
    "request_id": "",
    "connector_bin_id": "101",
    "cardholder_id": "8401",
    "group_id": "",
    "charge_amount": "10",
    "card_alias": "cxyqbitcard",
    "pieces": "1",
    "start_date": "2024-11-15",
    "end_date": "2025-12-30",
    "enable_currency_check": "true",
    "enable_shared": "false",
    "enable_multi_use": "true",
    "company_id": "4101",
    "sign": "2C9A905C5A754FFD4262E5A73CD21E1AC2A8626A75E37059AF00E3C32150937B"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://sandbox.vcc.top/api/card/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "",
    "connector_bin_id": "101",
    "cardholder_id": "8401",
    "group_id": "",
    "charge_amount": "10",
    "card_alias": "cxyqbitcard",
    "pieces": "1",
    "start_date": "2024-11-15",
    "end_date": "2025-12-30",
    "enable_currency_check": "true",
    "enable_shared": "false",
    "enable_multi_use": "true",
    "company_id": "4101",
    "sign": "2C9A905C5A754FFD4262E5A73CD21E1AC2A8626A75E37059AF00E3C32150937B"
}'

Responses

🟢200Success

application/json

Body

code

integer

required

msg

object

required

zh-CN

string

required

en-US

string

required

data

object

required

createResultInfoList

array [object {22}]

required

Example

{
    "code": 0,
    "msg": {
        "zh-CN": "成功",
        "en-US": "Success"
    },
    "data": {
        "createResultInfoList": [
            {
                "status": "1",
                "errorMsg": null,
                "cardNumber": "4040388623718106",
                "cvv": "441",
                "expireYear": "2025",
                "expireMonth": "12",
                "cardId": 100029801,
                "cardGroupId": null,
                "cardholderId": 8401,
                "cardBinId": 101,
                "amount": 10,
                "currency": "USD",
                "cardAlias": "cxyqbitcard",
                "pieces": 1,
                "currencyCheck": "1",
                "groupName": null,
                "isOneTime": "1",
                "amountLimit": null,
                "applicationDate": "2024-11-15 11:40:48",
                "validStarDate": "2024-11-15",
                "validEndDate": "2025-12-30",
                "reqNo": 115601
            }
        ]
    }
}