Create a new card

Request

Header Params

Authorization

string

required

Example:

Bearer {{access_token}}

Content-Type

string

required

Example:

application/json

idempotency-key

string

required

Example:

Body Params application/json

wallet_id

string

required

program_id

string

required

Example

{
    "wallet_id": "477f7da7-faeb-4497-b97a-d39e7e921d9f",
    "program_id": "ee3620d0-2f97-47a2-955d-b2975cc76747"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/customers/v1/cards' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'idempotency-key: {{$string.uuid}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "wallet_id": "477f7da7-faeb-4497-b97a-d39e7e921d9f",
    "program_id": "ee3620d0-2f97-47a2-955d-b2975cc76747"
}'

Responses

🟢201Created

application/json

Body

A card object representing either a physical or virtual card.

id

string <uuid>

required

The unique identifier of the card.

type

enum<string>

required

The type of card (virtual or physical).

Allowed values:

VIRTUALPHYSICAL

wallet_id

string <uuid>

required

The wallet ID associated with the card.

created_at

string <date-time>

required

The date and time the card was created.

updated_at

string <date-time>

required

The date and time the card was last updated.

status

enum<string>

required

The current status of the card.

Allowed values:

ACTIVEINACTIVESUSPENDEDSTOLENPENDING

external_id

string

required

An external identifier associated with the card.

Example:

1111111

last_four_digit

string

required

The last four digits of the card number.

Example:

1111

expiry

string <date-time>

required

The expiration date of the card.

program_id

string <uuid>

required

The associated card program ID.

m_pan

string

required

The masked primary account number (PAN) of the card.

Example:

1111***1111

Example

{
    "id": "1b8ecc17-4edd-4b74-ae4f-208aeb78f105",
    "type": "VIRTUAL",
    "wallet_id": "13655985-8198-ffde-7afe-6abc661df281",
    "created_at": "2025-01-13T18:26:41.332Z",
    "updated_at": "2025-01-13T18:26:41.332Z",
    "status": "INACTIVE",
    "external_id": "1111111",
    "last_four_digit": "1111",
    "expiry": "2010-08-12T12:16:43.197Z",
    "program_id": "0e8563e6-d25e-0f83-18ac-d053dff141c3",
    "m_pan": "1111***1111"
}