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

Replacement request accepted for async processing.

This response does not have a body.

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

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

Modified at 2026-02-19 17:53:55

Cancel Card

Set / Reset Card PIN