Replace or renew card

POST

/customers/v1/cards/{id}/{action}

Renew or replace an existing card based on the action provided (replace or renew).

Request

Path Params

Header Params

Body Params application/json

Example

{
    "reason": "string",
    "expiry": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/customers/v1/cards//' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'idempotency-key: {{$string.uuid}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reason": "string",
    "expiry": "string"
}'

Responses

🟢200OK

application/json

Body

Example

{
    "id": "1b8ecc17-4edd-4b74-ae4f-208aeb78f105",
    "type": "PHYSICAL",
    "wallet_id": "7b050dab-889e-5d33-6142-0f7cacb90f2a",
    "created_at": "2025-01-13T17:29:20.127Z",
    "updated_at": "2025-01-13T17:29:20.127Z",
    "status": "SUSPENDED",
    "external_id": "1111111",
    "last_four_digit": "1111",
    "expiry": "2011-10-04T06:36:49.799Z",
    "program_id": "a95b68b6-7bf1-56d6-fbcc-fc235b6b824e",
    "m_pan": "1111***1111"
}

Modified at 2025-01-27 04:36:39

Update card status

Generate card secret