Display digital card

Overview

Retrieve one or more digital cards and their properties.

Flow

Use the D1 SDK in the issuer application to retrieve NFC Payment digital cards.

The D1 SDK exposes two APIs for this flow:

• D1PayWallet.getDigitalCard() returns one digital card for the provided cardID.
• D1PayWallet.getDigitalCardList() returns a map of cardID values and their digital cards.

Both APIs return a D1PayDigitalCard object with the following properties:

• Digital card state: active or inactive.
• Payment network: Visa or Mastercard.
• Expiry date.
• Last four digits.
• Terms and conditions URL.
• Whether replenishment is required.
• Whether ODA replenishment is required.
• Number of payments left before replenishment is required.
• Whether the digital card is the default card for payment.

To retrieve card art, use D1Task.getCardMetadata() and CardMetadata.getAssetList().

SDK

Get a digital card

Android Java

D1PayWallet d1PayWallet = d1Task.getD1PayWallet();
String d1CardID = "";
d1PayWallet.getDigitalCard(d1CardID,
    new D1Task.Callback<D1PayDigitalCard>() {
        @Override
        public void onSuccess(@NonNull D1PayDigitalCard digitalCard) {
            String cardID = digitalCard.getCardID();
            State state = digitalCard.getState();
            Scheme scheme = digitalCard.getScheme();
            String expiryDate = digitalCard.getExpiryDate();
            String last4 = digitalCard.getLast4();
            String tncURL = digitalCard.getTncURL();
            boolean isReplenishmentNeeded = digitalCard.isReplenishmentNeeded();
            boolean isAuthenticationRequired = digitalCard.isAuthenticationRequiredBeforeReplenishment();
            boolean isODAReplenishmentNeeded = digitalCard.isODAReplenishmentNeeded();
            int numberOfPaymentsLeft = digitalCard.getNumberOfPaymentsLeft();
            boolean isDefault = digitalCard.isDefaultCard();
        }

        @Override
        public void onError(@NonNull D1Exception exception) {
            // Refer to D1 SDK Integration – Error Management section
        }
    }
);

Get all digital cards

Android Java

D1PayWallet d1PayWallet = d1Task.getD1PayWallet();
d1PayWallet.getDigitalCardList(
    new D1Task.Callback<Map<String, D1PayDigitalCard>>() {
        @Override
        public void onSuccess(@NonNull Map<String, D1PayDigitalCard> digitalCards) {
            for (Map.Entry<String, D1PayDigitalCard> entry: digitalCards.entrySet()) {
                String d1CardID = entry.getKey();
                D1PayDigitalCard digitalCard = entry.getValue();
            }
        }

        @Override
        public void onError(@NonNull D1Exception exception) {
            // Refer to D1 SDK Integration – Error Management section
        }
    }
);