Renew card validity

Renew a card's validity period in hours.

Renewal can be done for VIRTUAL cards and activated PLASTIC cards that were created or reissued with the validity_period_hours field set to a defined value greater than zero.

When a card reaches its valid_until date, the card's status is set to INOPERATIVE. When this happens, a Card updated event is generated.

For existing cards that never had validity_period_hours defined, you can do it through this endpoint.

When the card is renewed:

  • A new valid_until date is calculated and a Card updated event is generated with operation type = CARD_VALIDITY_RENEWAL.

  • If the card's status is INOPERATIVE, the status changes to NORMAL.

  • If the card's status is NORMAL, REISSUED, BLOCKED, PENDING or WARNING, the status remains the same.

Note: This endpoint requires an account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a 401 Unauthoried error message.

Language
Credentials
Bearer
JWT
URL
Click Try It! to start a request and see the response here!