Inscribir tarjetas mediante el SDK de D1

Descripción general

Esta página explica cómo la aplicación del emisor puede inscribir una tarjeta y a su usuario final en Click to Pay mediante el SDK D1.

La aplicación del emisor llama a inscribir, lo que desencadena la misma operación de inscripción de Click to Pay en el backend que cuando el backend del emisor llama a API de D1.

Utilice este flujo del SDK cuando quiera que el usuario final inicie la inscripción en Click to Pay directamente en la interfaz de usuario de la aplicación del emisor mientras D1 orquesta las interacciones de backend con los directorios de Click to Pay y la red de pago.

Flujo

El siguiente diagrama ilustra los pasos principales del flujo de inscripción de Click to Pay del SDK:

Diagrama de secuencia

Desde D1 SDK 4.2.0, con la incorporación del flujo de backend, la inscribir (Android / iOS) API también está disponible a través de D1 SDK.

Requisitos previos

El flujo del SDK tiene los mismos requisitos previos y limitaciones que el flujo de backend. Consulte los requisitos previos.

El siguiente diagrama de secuencia muestra el flujo iniciado desde la aplicación del emisor:

Puntos clave

• La aplicación del emisor debe proporcionar la información del consumidor. Consulte ConsumerInfo (API del SDK).
• La inscripción es una operación asíncrona. El resultado final se puede obtener mediante:

  • usando el estado de devolución de llamada (SUCCESSFUL o PENDING),
  • llamando al Obtener operación punto final disponible en el API de D1, o
  • activando las notificaciones D1. En el flujo del SDK, el emisor también puede activar notificaciones push en la aplicación además de las notificaciones del backend del emisor.
• El TSP asociado con la red de pago desencadena un flujo típico de digitalización.

Gestionar notificaciones push de Click to Pay

Antes de que la aplicación del emisor pueda recibir notificaciones de inscripción en Click to Pay desde el backend D1, asegúrese de que las notificaciones push estén configuradas de la siguiente manera:

1

Configurar notificaciones push

Realice las acciones necesarias tal como se indica en configuración de notificaciones push.

2

Registrar el token de notificación push

Registrar el token de notificación push.

3

Registrarse para recibir notificaciones de mensajes

Registrarse para notificaciones de mensajes.

Una vez completados estos pasos, la aplicación del emisor puede empezar a recibir notificaciones push como clickToPayEnrolment y clickToPayOptOutCard.

Cuando D1 SDK recibe una notificación push de tipo clickToPayEnrolment (Android / iOS) o clickToPayOptOutCard (Android / iOS), la aplicación del emisor revisa la notificación para determinar si la operación de inscripción en Click to Pay o la exclusión voluntaria se ha realizado correctamente.

API del SDK

Android - Kotlin

fun enrolClick2Pay(d1Task: D1Task, cardID: String) {
    // Información del consumidor recibida de la entrada del usuario o del backend.
    val consumerInfo = ConsumerInfo(
        "Bella",
        "segundo nombre",
        "Lin",
        "en-US",
        "+65",
        "99998888",
        "[e-mail]"
    )
    val billingAddress = BillingAddress("CZ")

    val callback: D1Task.Callback<Status?> =
        object : D1Task.Callback<Status?> {
            override fun onSuccess(data: Status?) {
                // Inscripción en Click to Pay exitosa
                val status: Status? = data
                val operationID = data?.operationID
            }

            override fun onError(exception: D1Exception) {
                // Consulte la sección Integración del SDK de D1 – Gestión de errores.
            }
        }
    d1Task.getClickToPayService().enrol(
        cardID,
        consumerInfo,
        "Bella Lin",
        billingAddress,
        callback
    )
}

Android - JAVA

public void enrolClick2Pay(@NonNull D1Task d1Task, @NonNull String cardID) {
    // Información del consumidor recibida de la entrada del usuario o del backend.
    ConsumerInfo consumerInfo = new ConsumerInfo(
        "Bella", 
        "segundo nombre", 
        "Lin", 
        "en-US", 
        "+65", 
        "99998888", 
        "[e-mail]"
    );
    BillingAddress billingAddress = new BillingAddress("CZ");

    D1Task.Callback<Status> callback = new D1Task.Callback<Status>() {
        @Override
        public void onSuccess(Status data) {
            // Inscripción en Click to Pay exitosa
            Status status = data;
            String operationID = data.operationID;
        }

        @Override
        public void onError(D1Exception exception) {
            // Consulte la sección Integración del SDK de D1 – Gestión de errores.
        }
    };
    d1Task.getClickToPayService().enrol(
            cardID,
            consumerInfo,
            "Bella Lin",
            billingAddress,
            callback);
}

iOS

let cardID = ""
let name = "Bella Lin"
let consumerInfo = ConsumerInfo(firstName: "Bella",
                                middleName: nil,
                                lastName: "Lin",
                                language: "en-US",
                                phoneNumberCountryCode: "+65",
                                phoneNumber: "99998888",
                                email: "[e-mail]")

let billingAddress = BillingAddress(line1: "1230 Rue de Rivoli",
                                    line2: nil,
                                    line3: nil,
                                    city: "Paris",
                                    state: "75",
                                    zipCode: "75000",
                                    countryCode: "FR")
do {
    let status = try await d1Task.clickToPayService().enrol(cardID,
                                                            consumerInfo: consumerInfo,
                                                            name: name,
                                                            billingAddress: billingAddress)
    switch status {
    case .pending(let operationID):
        // Inscripción en Click to Pay pendiente.
        print(operationID)
    case .successful(let operationID):
        // Inscripción en Click to Pay completada correctamente.
        print(operationID)
    }
} catch {
    // Gestionar el error.
}