2025-03-25
  • 2025-03-25
  • 2025-01-20
  • 2022-03-14
Help Center
VCCHUB How-to
2025-03-25
  • 2025-03-25
  • 2025-01-20
  • 2022-03-14
  1. Cardholder
  • 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 APM payment
        POST
      • Create a redirect (iFrame) payment
        POST
      • Query a transaction
        POST
      • Capture a transaction
        POST
      • Review a transaction
        POST
      • Cancel a transaction
        POST
      • Cancel a subscription
        POST
      • Refund a transaction
        POST
      • Search a refund transaction
        POST
      • Create a payout
        POST
      • Optimise payment methods
        POST
    • Issuing
      • Cardholder
        • Create cardholder
          POST
        • Delete cardholder
          POST
        • Query cardholder
          POST
      • Group
        • Create group
        • Query group details
        • Delete group
        • Group Card Withdrawal
        • Update group status
        • Recharge group
        • Query rule
      • Card
        • Create a card
        • Query card details
        • Query card transaction
        • Cancel a card
        • Withdraw from a card
        • Update card status
        • Recharge card
        • Update shared card limit
        • Query for card operation
        • Query card BIN
  • Appendix
    • Test Cards
    • Bank Code
    • Country Code
    • Currency Code
    • Payment Methods
  1. Cardholder

Create cardholder

POST
https://sandbox.vcc.top/api/cardholder/create
Create a new cardholder

Request

Header Params

Body Params application/json

Example
{
    "first_name": "zheng",
    "last_name": "hhhh1",
    "email": "robin2@email.com",
    "mobile_prefix": "+86",
    "mobile": "945632262",
    "birth_date": "1998-07-02",
    "billing_country_code": "US",
    "billing_state": "NY",
    "billing_city": "ASDA",
    "billing_address": "1600 Amphitheatre Parkway",
    "billing_postal": "94043",
    "remark": "test",
    "company_id": "{{companyId}}",
    "request_id": "rk-00008",
    "sign": "{{sign}}"
}

Request Code 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/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "first_name": "zheng",
    "last_name": "hhhh1",
    "email": "robin2@email.com",
    "mobile_prefix": "+86",
    "mobile": "945632262",
    "birth_date": "1998-07-02",
    "billing_country_code": "US",
    "billing_state": "NY",
    "billing_city": "ASDA",
    "billing_address": "1600 Amphitheatre Parkway",
    "billing_postal": "94043",
    "remark": "test",
    "company_id": "{{companyId}}",
    "request_id": "rk-00008",
    "sign": "{{sign}}"
}'

Responses

🟢200OK
application/json
Body

Example
{
    "code": "0000",
    "message": "Success",
    "result": {
        "remark": "test",
        "status": "1",
        "cardholder_id": "1952564520941649920",
        "company_id": 3201,
        "first_name": "zheng",
        "last_name": "hhhh1",
        "email": "robin2@email.com",
        "mobile_prefix": "+86",
        "mobile": "945632262",
        "birth_date": "1998-07-02",
        "billing_country_code": "US",
        "billing_state": "NY",
        "billing_city": "ASDA",
        "billing_address": "1600 Amphitheatre Parkway",
        "billing_postal": "94043",
        "cardholder_status": "1",
        "created_time": "2025-08-05T02:57:13.000+00:00"
    }
}
Previous
Optimise payment methods
Next
Delete cardholder