Create card
Create a new card for a customer.
Headers
Required for POST requests. Reuse the key only when retrying the same operation with an identical payload.
Request Body
ID of the customer to create a card for
Maximum spending limit on the card
Name to be printed on the card
Type of card to create
Possible values: virtual, physical
The shipping address for delivering a physical card. Provide this field only when the card type is physical.
Shipping method
Possible values: standard, express, international, apc, uspsInternational, overnight
Request Examples
{
"customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
"card_type": "virtual",
"card_limit": 50,
"name_on_card": "Jane Doe"
}
{
"customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
"card_type": "physical",
"card_limit": 50,
"name_on_card": "Jane Doe",
"shipping_address": {
"address_line1": "201 Allen St",
"city": "New York",
"state": "New York",
"postal_code": 10002,
"country_code": "US",
"phone_number": "12125550123",
"method": "standard"
}
}
Responses
| Status | Description |
|---|---|
200 |
Card creation request accepted |
200 response
Status message for the card creation request
Indicates whether the operation was accepted
ID of the newly created card
Whether the issuance fee was successfully charged
True when the fee charge was attempted but failed (for example, insufficient balance) and is queued for retry. The card is still issued.
ID of the fee record, present when a fee was charged
{
"data": {
"message": "Card creation request is processing",
"status": true,
"id": "dce0192a-9b3d-440b-9500-33dc9ac8dc20",
"fee_charged": true,
"fee_pending": false,
"fee_id": "fee_abc123"
},
"error": null
}
Authorization
- ApiKeyAuth