Renew tokens from the TSP

Token renewal applies only to existing tokens. These tokens are already provisioned and activated in a digital wallet application.

Agree with your payment network on the LCM policy to apply to issued tokens. Based on that policy, the TSP issues tokens with an appropriate expiration date.

When a token expires, the payment network TSP can reprovision it. It provisions a new token with a new expiration date.

You can opt in to receive a callback when the renewal completes (or fails).

Flow

This diagram shows the token renewal flow. It also shows the callback used to confirm the result.

Token renewal initiated by the payment network TSP.

Handle the callback

When the renewal completes (or fails), you receive notifyVirtualCardChange.

See notifyVirtualCardChange.

notifyVirtualCardChange parameters:

Parameter	Description
x-correlation-id	Correlates this callback with the related token renewal operation.
virtualCardId	Identifies the updated token.
action	Specifies the action performed. For token renewal, the value is RENEW.

Handle notifyVirtualCardChange idempotently. Callbacks can be duplicated or delayed.

This currently applies to:

• Mastercard

• Visa

Related documentation

• Update token state from issuer backend

• Update token state from wallet provider