Query card details

Request

Body Params application/json

request_id

string

optional

Unique identifier

<= 100 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 + api_key))
All encryption parameters need to remove spaces before encryption.

<= 100 characters

Example

{
  "cardId": "100029801",
  "companyId": "4101",
  "sign": "F733140F74DCFFB6C0D491F33C6061E40A822554606CA488882C19D4FBE9763C"
}

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/query' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cardId": "100029801",
    "companyId": "4101",
    "sign": "F733140F74DCFFB6C0D491F33C6061E40A822554606CA488882C19D4FBE9763C"
}'

Responses

🟢200Success

application/json

Body

code

integer

required

msg

object

required

zh-CN

string

required

en-US

string

required

data

object

required

cardId

integer

required

cardAlias

string

required

cardNumber

string

required

cvv

string

required

expireYear

string

required

expireMonth

string

required

balance

integer

required

cardholderId

integer

required

status

string

required

groupName

null

required

cardType

string

required

isOneTime

string

required

amountLimit

null

required

applicationDate

string

required

validStarDate

string

required

validEndDate

string

required

merchants

null

required

merchantsRestriction

null

required

merchantCategories

null

required

merchantCategoriesRestriction

null

required

spendingTransactionLimit

null

required

Example

{
  "code": 0,
  "msg": {
    "zh-CN": "成功",
    "en-US": "Success"
  },
  "data": {
    "cardId": 100029701,
    "cardAlias": "cxyqbitcard",
    "cardNumber": "4040386490382956",
    "cvv": "106",
    "expireYear": "2025",
    "expireMonth": "12",
    "balance": 0,
    "cardholderId": 8401,
    "status": "2",
    "groupName": null,
    "cardType": "1",
    "isOneTime": "1",
    "amountLimit": null,
    "applicationDate": "2024-11-15 11:36:32",
    "validStarDate": "2024-11-15 00:00:00",
    "validEndDate": "2025-12-30 00:00:00",
    "merchants": null,
    "merchantsRestriction": null,
    "merchantCategories": null,
    "merchantCategoriesRestriction": null,
    "spendingTransactionLimit": null
  }
}