Skip to main content
POST
Create a card

Authorizations

Authorization
string
header
required

API key (sk_test_... or sk_live_...)

Body

application/json
customer_code
string<uuid>
required
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

product_code
string<uuid>
required

Code of the card product, from GET /cards/products

Example:

"019abc12-3456-7890-abcd-ef0123456789"

name_on_card
string
required

Label of the card, 3 to 20 characters

Required string length: 3 - 20
Example:

"John Doe"

amount
number

Initial load in USD. Required when the product has initial_load.required: true, within initial_load.min and initial_load.max. Ignored otherwise.

Example:

100

Response

Card creation initiated

success
boolean
Example:

true

data
object
meta
object