Inscribir tarjetas mediante el SDK de D1

Resumen

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

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

Use este flujo del SDK cuando desee 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 en 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 SDK D1.

Prerrequisitos

El flujo del SDK tiene los mismos prerrequisitos y limitaciones que el flujo de backend. Consulte 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 asincrónica. El resultado final puede recuperarse 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 de D1. En el flujo del SDK, el emisor también puede activar notificaciones push en la app además de las notificaciones del backend del emisor.

• El TSP asociado con la red de pago activa un flujo de digitalización típico.

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 de D1, asegúrese de que las notificaciones push estén configuradas de la siguiente manera:

1

Configurar notificaciones push

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

2

Registrar 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 comprueba la notificación para determinar si la operación de inscripción en Click to Pay o la exclusión es exitosa.

API del SDK

Android - Kotlin

fun enrolClick2Pay(d1Task: D1Task, cardID: String) {
    // Información del consumidor recibida desde la entrada del usuario o el backend.
    val consumerInfo = ConsumerInfo(
        "Bella",
        "middle name",
        "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) {
                // Consulta la sección D1 SDK Integration – Error Management.
            }
        }
    d1Task.getClickToPayService().enrol(
        cardID,
        consumerInfo,
        "Bella Lin",
        billingAddress,
        callback
    )
}

Android - JAVA

iOS