Skip to main content
POST
/
api
/
yativo-card
/
create
curl -X POST 'https://crypto-api.yativo.com/api/yativo-card/create' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_id": "acc_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "card_type": "physical",
    "card_program": "MASTERCARD",
    "currency": "USD",
    "label": "Operations Card",
    "shipping_name": "Jane Doe",
    "shipping_address": {
      "line1": "123 Main Street",
      "city": "New York",
      "country": "US",
      "postal_code": "10001"
    }
  }'

{
  "status": "success",
  "message": "Physical card created successfully",
  "data": {
    "card_id": "crd_01HX9KZMB3F7VNQP8R2WDGT4FK",
    "card_type": "physical",
    "card_program": "MASTERCARD",
    "currency": "USD",
    "label": "Operations Card",
    "status": "pending",
    "masked_pan": "5200 **** **** 3456",
    "expiry_month": "03",
    "expiry_year": "2029",
    "shipping_tracking_number": null,
    "created_at": "2026-03-26T12:00:00Z"
  }
}
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
account_id
string
required
The ID of the account to associate the card with.
​
card_type
string
required
Must be physical for a physical card.
​
card_program
string
The card network to use. One of: VISA, MASTERCARD.
​
currency
string
The billing currency for the card. Defaults to USD.
​
label
string
An optional human-readable nickname for the card, e.g. "Operations Card".
​
shipping_name
string
required
The full name of the recipient to print on the shipping label.
​
shipping_address
object
required
The delivery address for the physical card.
curl -X POST 'https://crypto-api.yativo.com/api/yativo-card/create' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_id": "acc_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "card_type": "physical",
    "card_program": "MASTERCARD",
    "currency": "USD",
    "label": "Operations Card",
    "shipping_name": "Jane Doe",
    "shipping_address": {
      "line1": "123 Main Street",
      "city": "New York",
      "country": "US",
      "postal_code": "10001"
    }
  }'

{
  "status": "success",
  "message": "Physical card created successfully",
  "data": {
    "card_id": "crd_01HX9KZMB3F7VNQP8R2WDGT4FK",
    "card_type": "physical",
    "card_program": "MASTERCARD",
    "currency": "USD",
    "label": "Operations Card",
    "status": "pending",
    "masked_pan": "5200 **** **** 3456",
    "expiry_month": "03",
    "expiry_year": "2029",
    "shipping_tracking_number": null,
    "created_at": "2026-03-26T12:00:00Z"
  }
}