Digitize card

Overview

After the card passes eligibility checks and the end user accepts the terms and conditions (T&C), start digitization.

During the digitization:

• The issuer backend returns the Tokenization decision: green flow, yellow flow, or red flow.

• If the issuer approves (green flow or yellow flow):

  • The TSP creates the digital card and its assets (profile and payment keys).

  • The NFC Wallet SDK securely provisions the digital card profile and payment keys in the digital wallet application.

In the yellow flow, the digital wallet application performs ID&V (step-up authentication).

Implement the green flow, the yellow flow, or both. Choose based on your program.

Depending on your program, T&C might not be required. If so, the digital wallet application can accept the T&C without end user interaction.

SDK integration

Start Tokenization by calling CardDigitizationService.digitizeCard().

Track progress by listening to CardDigitizationService.eventStream.

Handle the outcome based on the emitted state:

• Green flow (approved, no step-up): .digitizationApproved

  • For detailed SDK integration steps, see Green flow digitization.

• Yellow flow (approved with step-up): .digitizationApprovedWithIDV

  • For detailed SDK integration steps, see Yellow flow digitization.

• Red flow (declined): .digitizationDeclined

  • Handle red flow

Handle Tokenization errors

The CardDigitizationService.digitizeCard() call may throw an error during Tokenization.

Handle these error types:

• clientError: Handle a local error in the NFC Wallet SDK.

• serverError: Handle an error returned by the service.

• networkError: Handle a missing internet connection on the device.