# 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 align="center" src="https://files.readme.io/edd9dcf263826661c3330d8cfdb1d8f7a56dbe6559345b30663a26c8c2557bcd-image_3.png" />

**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.

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](https://developers.pismo.io/pismo-docs/reference/put-v1-card-activate), it changes to NORMAL. |
| Noname                   | UNBOUND        | When [assigned to a customer](https://developers.pismo.io/pismo-docs/reference/post-v2-card-bind) its status becomes CREATED. Once activated, it becomes NORMAL.          |
| Reissued                 |                | Depends. Refer to the [Card reissuing](https://developers.pismo.io/pismo-docs/docs/card-reissuing)  guide.                                                           |

## Card status enums

The following table contains current card status enums. "**Type**" here is an unofficial grouping.

<Table align={[null,"left",null]}>
  <thead>
    <tr>
      <th>
        Enum
      </th>

      <th>
        Type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        CREATED
      </td>

      <td>
        Initial
      </td>

      <td>
        Created in the system.
      </td>
    </tr>

    <tr>
      <td>
        UNBOUND
      </td>

      <td>
        Initial
      </td>

      <td>
        Noname card not yet assigned to customer.
      </td>
    </tr>

    <tr>
      <td>
        NORMAL
      </td>

      <td>
        Active
      </td>

      <td>
        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](https://developers.pismo.io/pismo-docs/reference/put-v1-card-activate)
      </td>
    </tr>

    <tr>
      <td>
        REISSUED
      </td>

      <td>
        Active
      </td>

      <td>
        Card has been [reissued](https://developers.pismo.io/pismo-docs/reference/post-v1-card-reissue).
      </td>
    </tr>

    <tr>
      <td>
        UNNUMBERED
      </td>

      <td>
        Initial
      </td>

      <td>
        Card created without a PAN or a PIN that the issuer needs to define. Once the PAN is defined for a nominal card, the card's status becomes `CREATED`, for a noname card, its status becomes `UNBOUND`
      </td>
    </tr>

    <tr>
      <td>
        BLOCKED
      </td>

      <td>
        Temporary\
        block
      </td>

      <td>
        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](https://developers.pismo.io/pismo-docs/reference/post-v2-card-password-reset) endpoint.
      </td>
    </tr>

    <tr>
      <td>
        PENDING
      </td>

      <td>
        Temporary\
        block
      </td>

      <td>
        Created and is pending until further processing, such as account verification. Until then, transactions are disabled.
      </td>
    </tr>

    <tr>
      <td>
        WARNING
      </td>

      <td>
        Temporary\
        block
      </td>

      <td>
        A general alert flag is set and transactions are disabled. After investigation, it could, typically, transition to `FRAUD` or revert back to \`\`NORMAL\`.
      </td>
    </tr>

    <tr>
      <td>
        INOPERATIVE
      </td>

      <td>
        Maybe permanent
      </td>

      <td>
        Applies to physical, virtual, or temporary cards whose defined validity period has been exceeded. For more information, refer to [Configuring temporary cards](https://developers.pismo.io/pismo-docs/docs/cards-overview-1#configuring-temporary-cards) and [Custom expiration for virtual and physical cards](https://developers.pismo.io/pismo-docs/docs/cards-overview-1#custom-expiration-for-virtual-and-physical-cards)
      </td>
    </tr>

    <tr>
      <td>
        LOST
      </td>

      <td>
        Terminated
      </td>

      <td>
        Reported lost
      </td>
    </tr>

    <tr>
      <td>
        ROBBED
      </td>

      <td>
        Terminated
      </td>

      <td>
        Reported stolen
      </td>
    </tr>

    <tr>
      <td>
        EXPIRED
      </td>

      <td>
        Terminated
      </td>

      <td>
        Card date expiration reached. While card transactions are denied when this date is reached, it is the card issuer's responsibility to [update the status.](https://developers.pismo.io/pismo-docs/reference/put-v1-card-status)
      </td>
    </tr>

    <tr>
      <td>
        DAMAGED
      </td>

      <td>
        Terminated
      </td>

      <td>
        Damaged
      </td>
    </tr>

    <tr>
      <td>
        FRAUD
      </td>

      <td>
        Terminated
      </td>

      <td>
        Suspected fraud
      </td>
    </tr>

    <tr>
      <td>
        CANCELED
      </td>

      <td>
        Terminated
      </td>

      <td>
        Canceled
      </td>
    </tr>

    <tr>
      <td>
        DELETED
      </td>

      <td>
        Terminated
      </td>

      <td>
        Deleted
      </td>
    </tr>

    <tr>
      <td>
        BROKEN
      </td>

      <td>
        Terminated
      </td>

      <td>
        No longer physically usable
      </td>
    </tr>

    <tr>
      <td>
        THEFT
      </td>

      <td>
        Terminated
      </td>

      <td>
        Stolen
      </td>
    </tr>

    <tr>
      <td>
        DEFECT
      </td>

      <td>
        Terminated
      </td>

      <td>
        Has defect
      </td>
    </tr>
  </tbody>
</Table>

Call the [Update card status](https://developers.pismo.io/pismo-docs/reference/put-v1-card-status) endpoint to change a card's status.

## Card reissues

Card reissuing has been moved to its own guide, refer to [Card reissuing](https://developers.pismo.io/pismo-docs/docs/card-reissuing).