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.

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.

Card	Initial status	Notes
Virtual	NORMAL	Does not have to be activated.
Physical (plastic/metal)	CREATED	Can be overridden in program configuration to be NORMAL. After activation, it changes to NORMAL.
Noname	UNBOUND	When assigned to a customer its status becomes CREATED. Once activated, it becomes NORMAL.
Reissued		Depends. See 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.

Enum	Type	Description
CREATED	Initial	Created in the system.
UNBOUND	Initial	Noname card not yet assigned to customer.
NORMAL	Active	Active 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
REISSUED	Active	Card has been reissued.
BLOCKED	Temporary 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.
PENDING	Temporary block	Created and is pending until further processing, such as account verification. Until then, transactions are disabled.
WARNING	Temporary block	A general alert flag is set and transactions are disabled. After investigation, it could, typically, transition to `FRAUD` or revert back to ``NORMAL`.
LOST	Terminated	Reported lost
ROBBED	Terminated	Reported stolen
EXPIRED	Terminated	Card date expiration reached
DAMAGED	Terminated	Damaged
FRAUD	Terminated	Suspected fraud
CANCELED	Terminated	Canceled
DELETED	Terminated	Deleted
BROKEN	Terminated	No longer physically usable
THEFT	Terminated	Stolen
DEFECT	Terminated	Has defect

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

Card reissues

You need to reissue a card once it has a termination status. Similar to your embossing configuration, you need to personalize the card reissuing configuration and process for your brand as every brand has different reissue reasons and associated costs. After setting up your program, meet with your Pismo representative to configure this.

You can call the following APIs to view your reissuing configuration and reissue a card:

Get reissue reasons
Reissue card - Reissuing a physical card initiates the embossing process.

Card reissue scenarios and statuses

Scenario 1 - physical:

Card created (CREATED) and activated (NORMAL)
Card reissued with must_block = true(CANCELLED). (The reissue reason object contains the must_block field).
New card created (CREATED) and activated (NORMAL)

Scenario 2 - physical:

Card created (CREATED) and activated (NORMAL)
Card reissued with must_block = false(REISSUED)
New card created (CREATED) and activated (NORMAL)
Old card cancelled (REISSUED > CANCELLED)

Scenario 3 - virtual:

Card created and activated automatically (NORMAL)
Card reissued with must_block = true (CANCELLED). (The must_block flag is a field in the reissue reason object.)
New card created (CREATED) and activated (NORMAL)

Scenario 4 - virtual:

Card created and activated automatically (NORMAL)
Card reissued with must_block = false(REISSUED)
New card created (CREATED) and activated (NORMAL)
Old card cancelled (REISSUED > CANCELLED)

Automatic card reissue updates

This service is offered in partnership with Mastercard to simplify a customer's life. When a new customer card number is issued, it is automatically updated on the various websites, applications, and digital services where the customer already has a record with the old card.