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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Pismo card ID

Body Params

Request body

Card validity period object

integer
required
≥ 1

Sets a card's validity period in hours. Cannot exceed the card's expiration_date.

REQUIRED for a PLASTIC or VIRUTUAL card.

Responses

401

Access token is missing or invalid

403

You don't have permission to access this resource

500

Internal server error

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json