API
  1. Cardholder
API
  • Guides
    • Welcome
    • Interface
  • API Reference
    • Introduction
    • Endpoints
    • Data Types
    • Signing
    • 3-D Secure Verification
    • Subscription
    • Errors
    • Webhooks
    • Items Information
    • Changelog
    • Acquiring
      • Create a direct payment
        POST
      • Create a redirect (iFrame) payment
        POST
      • Query a transaction
        POST
      • Optimise payment methods
        POST
      • Search a refund transaction
        POST
      • Refund a transaction
        POST
      • Update an order
        POST
      • Review a transaction
        POST
      • Cancel a transaction
        POST
      • Capture a transaction
        POST
      • Create a payout
        POST
    • Issuing
      • Cardholder
        • Create cardholder
          POST
        • Delete cardholder
          POST
        • Query cardholder
          POST
      • Group
        • Create group
        • Query group details
        • Cancel group
        • Refund group
        • Update group status
        • Recharge group
      • Card
        • Create a card
        • Query card BIN
        • Recharge card
        • Withdraw from a card
        • Cancel a card
        • Update card status
        • Update card limit
        • Query card details
  • Appendix
    • Test Cards
    • Bank Code
    • Country Code
    • Currency Code
    • Payment Methods
  1. Cardholder

Query cardholder

POST
/cardholder/query
Retrieve details of a cardholder

Request

Body Params application/json
request_id
string 
optional
Unique identifier
<= 100 characters
cardholder_id
number 
required
Cardholder ID
company_id
number 
required
Merchant Code or Merchant ID or Merchant Number
sign
string 
required
Digital signatures information
Encryption Rule: touppercase(SHA256(company_id + cardholderId + api_key))
All encryption parameters need to remove spaces before encryption.
<= 100 characters
Example
{
    "request_id": "",
    "cardholderId": "8201",
    "companyId": "4101",
    "sign": "4B8ED59496489E132DFE27F296D57E9662969E497502508B53BD39C3AAAE3F79"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sandbox.vcc.top/api/cardholder/query' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "",
    "cardholderId": "8201",
    "companyId": "4101",
    "sign": "4B8ED59496489E132DFE27F296D57E9662969E497502508B53BD39C3AAAE3F79"
}'

Responses

🟢200OK
application/json
Body
code
integer 
required
msg
object 
required
zh-CN
string 
required
en-US
string 
required
data
object 
required
cardholderId
integer 
required
firstName
string 
required
lastName
string 
required
email
string 
required
mobilePrefix
string 
required
mobile
string 
required
birthDate
string 
required
countryCode
string 
required
billingState
string 
required
billingCity
string 
required
billingAddress
string 
required
billingPostal
string 
required
remark
string 
required
isStatus
string 
required
companyId
integer 
required
Example
{
    "code": 0,
    "msg": {
        "zh-CN": "成功",
        "en-US": "Success"
    },
    "data": {
        "cardholderId": 8201,
        "firstName": "Jon",
        "lastName": "Doe",
        "email": "test1811@email.com",
        "mobilePrefix": "+1",
        "mobile": "9521325",
        "birthDate": "1996-07-02 00:00:00",
        "countryCode": "US",
        "billingState": "NY",
        "billingCity": "New York",
        "billingAddress": "1600 Amphitheatre Parkway",
        "billingPostal": "94043",
        "remark": "test",
        "isStatus": "1",
        "companyId": 4101
    }
}
Previous
Delete cardholder
Next
Create group