Issue Card

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

Prerequisites:

Customer must exist and have an approved KYC/KYB status (if required by the product)

Product must be active and available

Card Types:

Virtual cards are issued instantly

Physical cards require a valid shipping_address and are dispatched by mail

The response contains a masked card number. Use GET /cards/{cardId}/sensitive to retrieve full PAN/CVV/expiry.

📋 Request Body Fields

⚠️ Required Fields

Field	Type	Description	Constraints
`customer_id`	`string (uuid)`	The customer to issue the card to. Example: `3fa85f64-5717-4562-b3fc-2c963f66afa6`	-
`product_id`	`string (uuid)`	The card product to use. Example: `7c9e6679-7425-40de-944b-e07fc1f90ae7`	-
`currency`	`string`	Currency for the card (ISO 4217, e.g., `GBP`, `USD`, `EUR`). Example: `GBP`	-

Optional Fields

Field	Type	Description	Constraints
`shipping_address`	`ShippingAddressDto`	Required for physical cards.	-

📤 Response Fields

Field	Type	Description	Notes
`id`	`string (uuid)`	- Example: `a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11`	-
`customer_id`	`string (uuid)`	-	-
`product_id`	`string (uuid)`	-	-
`product_name`	`string`	- Example: `GBP Virtual Prepaid`	nullable
`provider`	`string`	-	nullable
`card_type`	`string`	`virtual` or `physical`. Example: `virtual`	nullable
`card_number_masked`	`string`	Last 4 digits of the card number (e.g., `**4242`). Example: `**4242`	nullable
`currency`	`string`	- Example: `GBP`	-
`status`	`string`	Card status: `inactive`, `active`, `frozen`, `cancelled`. Example: `active`	-
`balance`	`number`	- Example: `450.0`	nullable
`created_at`	`string (date-time)`	-	-
`updated_at`	`string (date-time)`	-	nullable

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 '{ "customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "product_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "currency": "GBP" }'

{ "data": { "id": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11", "customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "product_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "product_name": "GBP Virtual Prepaid", "card_type": "virtual", "card_number_masked": "****4242", "currency": "GBP", "status": "inactive", "balance": 0, "created_at": "2024-01-15T10:30:00Z" }, "request_id": "req_card001", "timestamp": "2024-01-15T10:30:00Z" }

📋 Request Body Fields#

📤 Response Fields#

Request

Responses

📋 Request Body Fields

📤 Response Fields