Activate a card

This section describes how to activate a physical card when the card has been received.

For each product type, issuer has the flexibility to decide the card activation method:

• CVV
• Last 4 digits of the PAN

User Experience

Sample card activation screen in the Issuer Application

The activation challenge (last four digits of the PAN or CVV) is captured securely by D1 SDK.

Flow

High-level flow to activate a card

1. The user authenticates on the banking app and request to activate the card.
2. An internal call is made to the SDK
3. Capture securely the last 4 digits of the PAN
4. D1 BackEnd API
5. D1 validates the last 4 digits of the PAN with the one used to register card
6. D1 pushes card activation request to issuer backend

Sequence Diagram

Pre-requisites

• Consumer, account and card already registered in D1
• SDK is properly initialized
• Issuer App called D1 SDK login API.

Sequence diagram for card activation

Required APIs

API	Inbound/Outbound	Description
Get authorization token	Issuer <- Thales D1	Get an OAuth 2.0 access token to call the Issuer backend.
Activate card	Issuer <- Thales D1	Activate a physical card in issuer backend

SDK

Android

SecureEditText secureEditText = <Object of type SecureEditText>;
EntryUI entryUI = new EntryUI(secureEditText);
String cardID = "<Card ID>";

d1Task.activatePhysicalCard(cardID, entryUI, new D1Task.Callback<Void>() {
    @Override
    public void onSuccess(Void data) {
        // Proceed with subsequent flows. The card is now activated.
    }
    
    @Override
    public void onError(D1Exception exception) {
        // Refer to D1 SDK Integration – Error Management section
    }
});

iOS

let secureTextField = <Object of type D1SecureTextField>
let entryUI = EntryUI(entryTextField: secureTextField)
let cardID = <Card ID>

d1Task.activatePhysicalCard(cardID, entryUI: entryUI) { error in
    if let error = error {
        // Refer to D1 SDK Integration – Error Management section
    } else {
        // Proceed with subsequent flows. The card is now activated.
    }
}