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

​
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.
When you update a card via the Partially Update Card Endpoint, you can specify whether you want the token lifecycle to be driven by the state of the cards — impactTokenStatus parameter:
  • Set TRUE if you want card status to impact the token status. This implements a card-driven token lifecycle.
  • 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.

​
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 Reissue

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

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.

​
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?
No, 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.
  1. If the impactTokenStatus is set to FALSE, can a token of a card being replaced used for completing transactions?
Yes, 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.