Renew card expiration date

Renew a card via setting a new expiration date.

Notes:

  • Renewal can be done for PLASTIC and VIRTUAL cards.
  • Cards with status UNNUMBERED, UNBOUND, CREATED, or final status cannot be renewed.
  • This endpoint generates a Card updated event.
  • 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 Unauthorized error message.

For more information, refer to the Card renewal guide.

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 expiration date renewal object

string
required
^\d{4}$

New card expiration date. Format = YYMM.

MUST be later than the card's current expiration_date.

Responses

400

Bad request. Possible causes:

  • new_expiration_date is missing or not in YYMM format.

  • Month is not between 01 and 12.

  • new_expiration_date is not later than the card's current expiration date.

  • Card type is not PLASTIC or VIRTUAL.

  • Card status is UNNUMBERED, UNBOUND, CREATED or final status.

401

Access token is missing or invalid

403

You don't have permission to access this resource

404

The specified resource was not found

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