Card lifecycle and statuses

The following graphic shows the card lifecycle and statuses for nominal (physical - plastic or metal) cards, noname cards, and reissued cards. Card termination statuses are on the right.

Image shows the card lifecycle and statuses for nominal (physical - plastic or metal) cards, noname cards, and reissued cards. Card termination statuses are on the right.

Note: Termination statuses cannot be changed to an active or temporarily blocked status. A termination status can be updated to another termination status though, and a temporary status can also be updated to another temporary status.

Initial/default card statuses

The following table shows the initial (default) statuses for Pismo issued cards.

CardInitial statusNotes
VirtualNORMALDoes not have to be activated.
Physical (plastic/metal)CREATEDCan be overridden in program configuration to be NORMAL. After activation, it changes to NORMAL.
NonameUNBOUNDWhen assigned to a customer its status becomes CREATED. Once activated, it becomes NORMAL.
ReissuedDepends. Refer to Card reissues below.

Card status enums

The following table contains current card status enums. "Type" here is an unofficial grouping, and does not exist as enums in code.

EnumTypeDescription
CREATEDInitialCreated in the system.
UNBOUNDInitialNoname card not yet assigned to customer.
NORMALActiveActive and eligible for transactions. Default for virtual cards. The transition from CREATED to NORMAL is for physical cards and can only be done through the Activate physical card
REISSUEDActiveCard has been reissued.
BLOCKEDTemporary
block
Temporarily blocked until further status changes.

A card could be blocked, for example, if the cardholder has exceeded their allowed tries to enter a password. You can reset this for a cardholder with the Reset password try count endpoint.
PENDINGTemporary
block
Created and is pending until further processing, such as account verification. Until then, transactions are disabled.
WARNINGTemporary
block
A general alert flag is set and transactions are disabled. After investigation, it could, typically, transition to FRAUD or revert back to `NORMAL.
INOPERATIVEMaybe permanent This status applies only to temporary cards. For more information, refer to Configuring temporary cards
LOSTTerminatedReported lost
ROBBEDTerminatedReported stolen
EXPIREDTerminatedCard date expiration reached
DAMAGEDTerminatedDamaged
FRAUDTerminatedSuspected fraud
CANCELEDTerminatedCanceled
DELETEDTerminatedDeleted
BROKENTerminatedNo longer physically usable
THEFTTerminatedStolen
DEFECTTerminatedHas defect

Call the Update card status endpoint to change a card's status.

Card reissues

Card reissuing has been moved to its own guide, refer to Card reissuing .