> ## Documentation Index
> Fetch the complete documentation index at: https://nextgen-docs.enfuce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

Enfuce enables you to manage the lifecycle of a token in the following ways:

* Associate the token with its respective card and the card status impacts the token status: [Card-Driven Token Behaviour and lifecycle](#card-driven-token-behaviour-and-lifecycle)
* Manage the token lifecycle via the [Token Lifecycle API Endpoints](https://nextgen-docs.enfuce.com/guides/wallet/token-lifecycle/token-lifecycle-management-via-API).

## Card-Driven Token Behaviour and Lifecycle

A token lifecycle implies different states of the token that explain when a token is available for usage and/or when it is restricted/disabled from use. Each token has its own lifecycle, which is different from the lifecycle of a physical/virtual card, but closely associated with the card.

A token lifecycle is based on the card lifecycle, by default. This workflow conforms with the digital wallets and the card Scheme requirements, and is designed to ensure a smooth cardholder experience that minimises disruption.

<Note>When you update a card via the [Partially Update Card Endpoint](https://nextgen-docs.enfuce.com/api/cards/patch-card/partial-update-card), you can specify whether you want the token lifecycle to be driven by the state of the cards — `impactTokenStatus` parameter:
<ul><li>Set `TRUE` if you want card status to impact the token status. This implements a card-driven token lifecycle.</li><li>Set `FALSE` if you do not want the card status to impact the token status. This keeps the token lifecycle separate from the card lifecycle, and you can manage the token lifecycle with the [Token API Endpoints]().</li></ul></Note>

### Features of Card-Driven Token Behaviour

* **Token status change for multiple card applications**: Any change to the main card status impacts the status of the multiple card applications included with the main card, and it is also causes status changes for all tokens associated with the multiple card applications.

* **Token status does not impact card status**: Any status change of a specific token does not affect the associated main card, multiple card applications, or other tokens associated with the card.

### Card Status Impacting Token Behaviour

If the `impactTokenStatus` parameter is set to `TRUE`, the card status impacts the token status.

| Card Status               | Token Status                                                                                                                                                                                                                        | Use Case                                               |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| `ACTIVE`                  | Token is active and usable.                                                                                                                                                                                                         |                                                        |
| `BLOCKED`                 | All tokens linked to the card are suspended. <br /> <Note>If the blocked card status is changed to the `ACTIVE` state, the suspended token status also changes to the active state.</Note>                                          | Device lost/Interim risk mitigation                    |
| `BLOCKED_SUSPECTED_FRAUD` | All tokens linked to the card are suspended.                                                                                                                                                                                        | Device lost/Interim risk mitigation                    |
| `CLOSED`                  | Tokens linked to the card are permanently deactivated. <br /><Note>When a card is replaced, a new card is issued and the previous versions are closed. The existing tokens are moved to the new card without reprovisioning.</Note> | Confirmed device theft/device compromised due to fraud |
| `CLOSED_DUE_TO_FRAUD`     | Tokens linked to the card are permanently deactivated.                                                                                                                                                                              | Confirmed device theft/device compromised due to fraud |
| `CLOSED_LOST`             | Tokens linked to the card are permanently deactivated.                                                                                                                                                                              | Confirmed device theft/device compromised due to fraud |
| `CLOSED_STOLEN`           | Tokens linked to the card are permanently deactivated.                                                                                                                                                                              | Confirmed device theft/device compromised due to fraud |

### Card Reissue

<p>When a card is reissued, the associated tokens remain active. The digital wallets display the updated expiry date and do not require reprovisioning.</p>

<p>Hence, if the `impactTokenStatus` is set to `TRUE`, the cardholder can use the digital wallets for completing payments, while the physical card is being reissued.</p>

### Card Replacement

When a card is replaced, a new card is generated with a new card number (PAN). The associated tokens are automatically linked to the new card, and is available for usage. The digital wallet does not need to be reprovisioned.

This is especially helpful when the physical card is lost and is being replaced with a new card. If the new card has not yet been delivered; the cardholder can still use their digital wallet to complete payments. Once the card is replaced, the existing tokens are linked to the new card.

## Frequently Asked Questions

1. If the `impactTokenStatus` is set to `FALSE`, can a token of a card in `BLOCKED` status be used for completing transactions?

<div style={{marginLeft: '40px'}}>
  <strong>No</strong>, the token cannot be used for completing transactions. As the `impactTokenStatus` is set to `FALSE`, the token status in the digital wallet would show it in active state, yet during processing, Enfuce would decline the transaction based on the card status.
</div>

2. If the `impactTokenStatus` is set to `FALSE`, can a token of a card being replaced used for completing transactions?

<div style={{marginLeft: '40px'}}>
  <strong>Yes</strong>, a cardholder can use a token of a card being replaced to complete payments. Once the new card is delivered, the associated tokens in the digital wallet displays the updated expiry date.
</div>