Replace Card

Requests a replacement for a card — for example when it's lost, damaged, or expired. A new physical or virtual card is issued under the same customer and product; the old card is retired once the replacement is confirmed.

📤 Required Field

| reason | string | damaged card |

📤 Response Fields

Field	Type	Description
`id`	`string (uuid)`	Identifier of the original card
`replacementCardId`	`string (uuid)`	Identifier of the newly issued replacement card
`status`	`string`	Status of the replacement request, e.g. `processing`
`requestedAt`	`string (date-time)`	Timestamp the replacement was requested

curl --location '/api/v1/cardoperations/6f1c9a2e-4b3d-4e7a-9c5f-1a2b3c4d5e6f/replaceCard' \ --header 'X-API-Key;' \ --header 'X-Signature;' \ --header 'X-Timestamp;' \ --header 'X-Nonce;' \ --header 'X-Body-Hash;' \ --header 'Content-Type: application/json' \ --data '{ "reason": "Card damaged" }'

{ "cardId": "3d029c09-1fb2-4fb4-9aff-08faa00db828", "customerId": "ef66d76c-b44d-4fdc-a28a-9b3cda443fd4", "productId": "cab4a136-6f58-467b-8fc0-c99d76fb0712", "cardType": "Virtual", "cardNumber": "XXXX XXXX XXXX 9838", "action": "replace", "status": "Replacement Requested", "message": "Card replacement requested.", "taskId": "33b70ed0-c1c6-471e-a3fa-98e6edb5eb4b", "performedAt": "2026-08-31T11:36:58.2012832Z", "requestId": "e0ce6f111eba422689b00797effd0731", "timestamp": "2026-08-31T11:36:58.2962104Z" }

Request

Responses