Add digital card

Overview

If the card is not digitized, prompt the end user to digitize it to enable NFC Payment.

Flow

Use the D1 SDK in the issuer application to digitize the card when the end user enables NFC Payment.

The D1 SDK exposes the addDigitalCard() API for this flow.

Sequence diagram

Prerequisites

• The end user, account, and card are already registered in D1.

• The D1 SDK is initialized.

• The issuer application has called the D1 SDK login API.

Add digital card flow in the issuer application.

SDK

Android Kotlin

fun digitizeCardToD1Pay(d1Task: D1Task, cardID: String) {
    val d1PayWallet = d1Task.d1PayWallet

    val callback: D1Task.Callback<Void?> = object : D1Task.Callback<Void?> {
        override fun onSuccess(ignored: Void?) {
            // Digitization is successful.
        }

        override fun onError(exception: D1Exception) {
            // Refer to D1 SDK Integration – Error Management section
        }
    }
    d1PayWallet.addDigitalCard(cardID, callback)
}

Android Java

In D1 SDK flow, onSuccess means the card digitization is complete. The end user can use the digital card immediately after this callback.

In Android D1 SDK versions earlier than 4.1.0, card digitization requires a push notification to complete.

• The issuer application must forward the push notification to the D1 SDK. See Message Handling.

• The issuer application must register D1PayWallet.registerD1PayDataChangedListener() and wait for State.ACTIVE before treating the digital card as ready for payment.