Review card LCM

Overview

Using the D1 backend API, the issuer can suspend, resume, and delete cards:

• Card suspension or resumption has no effect on NFC Payment digital cards.

  For example, the end user can still pay with a digital card even if the physical card is suspended because it was lost.

• Card deletion deletes all the related digital cards in NFC Payment.

The next section explains how to handle card renewal.

Card renewal

Cards can be renewed when they expire or replaced if they are lost or stolen.

To display the correct card metadata, the issuer backend must send a renew or replace request to D1. If the request does not include encrypted card details, D1 calls the issuer backend through the Get Card Credentials API to retrieve the new card details.

If the renew operation updates the card ID, the issuer application should call one of the following APIs after it receives a PushResponseKey.TYPE_CARD_RENEWAL message:

• D1PayWallet.getDigitalCardList

• D1PayWallet.getDigitalCard

• D1PayWallet.getCardDigitizationState

Call D1Task.login before you call any of the APIs listed above.

In the background, card ID resynchronization starts automatically when all of the following conditions are met:

• The end user is logged in.

• The card renewal process completed successfully.

• There is no ongoing contactless payment.

• There is at least one digital card in the wallet.

• The card renewal happened after the last resynchronization.

• The last resynchronization happened more than 30 minutes ago.

If any of these conditions is not met, card ID resynchronization is skipped.

If D1PayWallet.getDigitalCard or D1PayWallet.getCardDigitizationState is called with the old card ID after a successful card ID resynchronization, the API may return D1Exception.ErrorCode.ERROR_CARD_NOT_FOUND.