Issue Card

POST

/{{baseurl}}/api/v1/cards

Issues a new card linked to a customer and a card product.

⚠️ Required Fields

Field	Type	Description
`customerId`	`string (uuid)`	The customer to issue the card to
`productId`	`string (uuid)`	The card product to use
`currency`	`string`	Currency for the card (ISO 4217, e.g. `GBP`)

Optional Fields

Field	Type	Description
`shippingAddress`	`object`	Required for physical cards. Fields: `addressLine1`, `addressLine2`, `city`, `state`, `postalCode`, `country`

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201

Card issued successfully.

This response does not have a body.

🟠401

🟠404

🟠422

Request Example

Shell

JavaScript

Java

Swift

cURL

Issue a virtual cardIssue a physical card with shipping address

curl --location -g --request POST '/{{baseurl}}/api/v1/cards' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "productId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "currency": "GBP"
}'

Modified at 2026-02-19 17:53:55

Submit KYC/KYB Applicant

Cards List