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 withoperation type
=CARD_VALIDITY_RENEWAL
. -
If the card's status is
INOPERATIVE
, the status changes toNORMAL
. -
If the card's status is
NORMAL
,REISSUED
,BLOCKED
,PENDING
orWARNING
, 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.