Skip to main content
POST
/
cards
/
virtual-cards
/
create
curl -X POST "https://api.cryptomate.me/cards/virtual-cards/create" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "card_holder_name": "John Doe",
    "email": "cardholder@example.com",
    "approval_method": "TOP_UP",
    "phone_country_code": 1,
    "phone": "5551234567",
    "daily_limit": 1000.00,
    "weekly_limit": 5000.00,
    "monthly_limit": 20000.00,
    "metadata": {
      "department": "engineering"
    }
  }'

{
  "id": "card_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
  "card_holder_name": "John Doe",
  "type": "VIRTUAL",
  "last4": "4242",
  "status": "ACTIVE",
  "approval_method": "TOP_UP",
  "daily_limit": 1000.00,
  "weekly_limit": 5000.00,
  "monthly_limit": 20000.00
}
Creates a new virtual card with the specified limits and cardholder information. Requires an API key with access level 2 or higher.

​
Body

​
card_holder_name
string
required
Name of the cardholder.
​
email
string
Email address for card notifications.
​
approval_method
string
required
Transaction approval method. Possible values: NONE, WEBHOOK, TOP_UP, DEFI.
​
phone_country_code
integer
required
Phone country code for OTP authentication.
​
phone
string
required
Phone number for OTP authentication (without country code).
​
daily_limit
number
Daily spending limit in USD.
​
weekly_limit
number
Weekly spending limit in USD.
​
monthly_limit
number
Monthly spending limit in USD.
​
metadata
object
Additional metadata key-value pairs for the card.

​
Response

​
id
string
Unique card identifier.
​
card_holder_name
string
Name of the cardholder.
​
type
string
Card type.
​
last4
string
Last 4 digits of the card number.
​
status
string
Current card status.
​
approval_method
string
Transaction approval method.
​
daily_limit
number
Daily spending limit in USD.
​
weekly_limit
number
Weekly spending limit in USD.
​
monthly_limit
number
Monthly spending limit in USD.
curl -X POST "https://api.cryptomate.me/cards/virtual-cards/create" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "card_holder_name": "John Doe",
    "email": "cardholder@example.com",
    "approval_method": "TOP_UP",
    "phone_country_code": 1,
    "phone": "5551234567",
    "daily_limit": 1000.00,
    "weekly_limit": 5000.00,
    "monthly_limit": 20000.00,
    "metadata": {
      "department": "engineering"
    }
  }'

{
  "id": "card_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
  "card_holder_name": "John Doe",
  "type": "VIRTUAL",
  "last4": "4242",
  "status": "ACTIVE",
  "approval_method": "TOP_UP",
  "daily_limit": 1000.00,
  "weekly_limit": 5000.00,
  "monthly_limit": 20000.00
}