API
  1. Card
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 APM payment
        POST
      • Create a redirect (iFrame) payment
        POST
      • Query a transaction
        POST
      • Refund a transaction
        POST
      • Search a refund transaction
        POST
      • Review a transaction
        POST
      • Cancel a transaction
        POST
      • Cancel a subscription
        POST
      • Capture a 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
        • Cancel group
        • Refund group
        • Update group status
        • Recharge group
      • Card
        • Create a card
          POST
        • Query card BIN
          POST
        • Recharge card
          POST
        • Withdraw from a card
          POST
        • Cancel a card
          POST
        • Update card status
          POST
        • Update card limit
          POST
        • Query card details
          POST
  • Appendix
    • Test Cards
    • Bank Code
    • Country Code
    • Currency Code
    • Payment Methods
  1. Card

Create a card

POST
/card/create
Create a new card

Request

Body Params application/json

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
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 '{
    "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

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
            }
        ]
    }
}
Modified at 2024-11-15 07:35:50
Previous
Recharge group
Next
Query card BIN