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_untildate 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,PENDINGorWARNING, 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.