Replace Card

Requests a replacement card (e.g., for lost, stolen, damaged, or expired cards). The existing card is cancelled and a new card is issued.

Returns 202 Accepted — the replacement is processed asynchronously

For physical cards, provide a shipping_address

A task_id in the response can be used to track the replacement status
Optional Fields

Field	Type	Description	Constraints
`reason`	`string`	Reason for replacement (e.g., `lost`, `stolen`, `damaged`, `expired`). Example: `Card damaged beyond use`	Nullable
`shipping_address`	`ShippingAddressDto`	-	-
Optional Fields

Field	Type	Description	Constraints
`reason`	`string`	Reason for replacement (e.g., `lost`, `stolen`, `damaged`, `expired`). Example: `Card damaged beyond use`	Nullable
`shipping_address`	`ShippingAddressDto`	-	-

📤 Response Fields

Field	Type	Description	Notes
`card_id`	`string (uuid)`	-	-
`customer_id`	`string (uuid)`	-	-
`product_id`	`string`	-	nullable
`card_type`	`string`	-	nullable
`action`	`string`	The operation performed: `activate`, `freeze`, `unfreeze`, `cancel`, `replace`, `set_pin`. Example: `activate`	-
`status`	`string`	New card status after the operation. Example: `active`	-
`message`	`string`	-	nullable
`task_id`	`string`	Async task ID for operations processed in the background.	nullable
`performed_at`	`string (date-time)`	-	-

curl --location -g --request POST '{{baseUrl}}/api/v1/cards/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11/replace' \ --header 'X-API-Key;' \ --header 'X-Signature;' \ --header 'X-Timestamp;' \ --header 'X-Nonce;' \ --header 'X-Body-Hash;' \ --header 'Content-Type: application/json' \ --data-raw '{ "reason": "Card damaged beyond use", "shipping_address": { "address_line_1": "10 Downing Street", "city": "London", "postal_code": "SW1A 2AA", "country": "GB" } }'

📤 Response Fields#

Request

Responses

📤 Response Fields