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. Card
  • 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
        • Delete cardholder
        • Query cardholder
      • Group
        • Create group
        • Query group details
        • Delete group
        • Group Card Withdrawal
        • Update group status
        • Recharge group
        • Query rule
      • Card
        • Create a card
          POST
        • Query card details
          POST
        • Query card transaction
          POST
        • Cancel a card
          POST
        • Withdraw from a card
          POST
        • Update card status
          POST
        • Recharge card
          POST
        • Update shared card limit
          POST
        • Query for card operation
          POST
        • Query card BIN
          POST
  • Appendix
    • Test Cards
    • Bank Code
    • Country Code
    • Currency Code
    • Payment Methods
  1. Card

Create a card

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

Request

Body Params application/json

Example
 {
    "card_bin_id": 101,
    "cardholder_id": "1952640595394691072",
    "recharge_amount": 1,
    "card_alias": "Ron Ko",
    "start_date":"2025-06-26",
    "end_date": "2026-07-20",
    "enable_multi_use": true,
    "card_type": "2",
    "group_id": "1952633906230591488",
    "company_id": "{{companyId}}",
    "request_id": "rk-0121",
    "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/card/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "card_bin_id": 101,
    "cardholder_id": "1952640595394691072",
    "recharge_amount": 1,
    "card_alias": "Ron Ko",
    "start_date":"2025-06-26",
    "end_date": "2026-07-20",
    "enable_multi_use": true,
    "card_type": "2",
    "group_id": "1952633906230591488",
    "company_id": "{{companyId}}",
    "request_id": "rk-0121",
    "sign": "{{sign}}"
}'

Responses

🟢200Success
application/json
Body

Example
{
    "code": "0000",
    "message": "Success",
    "result": {
        "create_result_list": [
            {
                "status": "1",
                "order_id": "1952640796222160896",
                "card_id": "1952640796553510913",
                "group_id": "1952633906230591488",
                "cardholder_id": "1952640595394691072",
                "card_number": "4040383149931929",
                "cvv": "738",
                "expire_year": "2026",
                "expire_month": "07",
                "card_limit": 1,
                "currency": "USD",
                "card_alias": "Ron Ko",
                "card_type": "2",
                "multi_use": true,
                "card_status": "1",
                "created_time": "2025-08-05T08:00:19.000+00:00",
                "valid_start_date": "2025-08-05",
                "valid_end_date": "2026-07-20",
                "recharge_amount": 1,
                "fee": 2
            }
        ]
    }
}
Previous
Query rule
Next
Query card details