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

application/json

Card issued successfully.

Body

🟠401

🟠404

🟠422

Request Example

Shell

JavaScript

Java

Swift

cURL

Issue a virtual cardIssue a physical card with shipping address

curl --location --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"
}'

Response Example

{
    "cardId": "a3f1c9d2-8b7e-4f61-9c2d-5a1234567890",
    "customerId": "ed2baa83-a988-4b4a-93ee-fad379500bbd",
    "productId": "b1f3c7a2-6c4e-4d91-9f2a-123456789abc",
    "cardType": "debit",
    "currency": "INR",
    "state": "active",
    "createdAt": "2026-03-30T12:30:45Z"
}

Modified at 2026-03-31 13:47:35

Get Applicant KYC Status

Cards List