Replace Card

POST

/baseurl/api/v1/cards/{cardId}/replace

Requests a replacement card.

Optional Fields

Field	Type	Description
`reason`	`string`	Reason for replacement. Nullable.
`shippingAddress`	`object`	Fields: `addressLine1`, `addressLine2`, `city`, `state`, `postalCode`, `country`

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢202

application/json

Replacement request accepted for async processing.

Body

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/baseurl/api/v1/cards//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",
    "shippingAddress": {
        "addressLine1": "10 Downing Street",
        "city": "London",
        "postalCode": "SW1A 2AA",
        "country": "GB"
    }
}'

Response Example

{
    "cardId": "ef0c9071-f1d5-4782-996c-db9b45c47a29",
    "customerId": "49cf2793-9379-4d1b-9904-5b77aaa5693c",
    "productId": "999a47bf-5c73-4a93-9827-0182f075355d",
    "cardType": "Virtual",
    "action": "replace",
    "status": "success",
    "message": "Card replaced successfully",
    "taskId": "task_123456789"
}

Modified at 2026-03-31 04:36:26

Cancel Card

Set / Reset Card PIN