Replace or renew card

POST

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

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

The card is re-issued on the same Kobble card id with a new PAN/expiry and is left INACTIVE; on replace the old network token is set to VOID. You must re-activate the card via PATCH /cards/{id}/status after every renew/replace.

Request

Path Params

Header Params

Body Params application/json

Example

{
    "reason": "damaged card",
    "expiry": "2029-12-01 00:00:00"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/customers/v1/cards//' \
--header 'Idempotency-Key: {{$string.uuid}}' \
--header 'x-client-id;' \
--header 'Content-Type: application/json' \
--data '{
    "reason": "damaged card",
    "expiry": "2029-12-01 00:00:00"
}'

Responses

🟢201Created

application/json

Card re-issued. The card is left INACTIVE and must be re-activated.

Bodyapplication/json

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": "INACTIVE",
    "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"
}

🟢202Accepted

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Modified at 2026-08-05 04:06:11

Update card status

Generate card secret