Create a card - Star SaaS

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
      }
    ]
  }
}