Recuperar perfiles mediante el SDK de D1

Resumen

Esta página explica cómo la aplicación del emisor puede recuperar perfiles de Click to Pay usando el SDK D1.

La aplicación del emisor llama a getProfiles (Android / iOS) API que activa el mismo comportamiento de recuperación del backend que cuando el backend del emisor llama a la API de obtención de perfiles de consumidor de Click to Pay.

Use este flujo del SDK cuando quiera mostrar los datos actuales del perfil de Click to Pay directamente en la aplicación del emisor, por ejemplo antes de permitir que el usuario final actualice los detalles del perfil u opte por excluir una tarjeta.

Enlaces rápidos

• Recuperar perfiles de Click to Pay

• Inscribir tarjetas con el SDK D1

• Actualizar perfiles de Click to Pay

• Excluir mediante el SDK D1

Flujo

El flujo de recuperación de perfiles del SDK sigue estos pasos:

1. La aplicación del emisor inicializa el SDK D1 e inicia sesión en el usuario final.

2. La aplicación del emisor llama a la operación de recuperación de perfiles de Click to Pay.

3. D1 envía la solicitud al backend de D1 utilizando el contexto autenticado del usuario final.

4. El backend D1 consulta los directorios de Click to Pay configurados.

5. D1 agrega el resultado y devuelve como máximo un perfil por red de pago a la aplicación del emisor.

Diagrama de secuencia

El flujo del SDK tiene el mismo comportamiento funcional que el flujo de recuperación de perfiles del backend, pero se inicia directamente desde la aplicación del emisor.

Para el diagrama de secuencia detallado, consulte Recuperar perfiles de Click to Pay.

Puntos clave

• Esta es una operación asíncrona. La aplicación del emisor recibe los perfiles actuales directamente en la devolución de llamada o en el resultado devuelto.

• La respuesta contiene una ProfileResult.Profile colección. Cada entrada representa un perfil de Click to Pay en un directorio de red de pago.

• Si se configuran varios directorios de Click to Pay, D1 consolida los perfiles en una sola respuesta.

• Si el usuario final existe en D1 pero no está inscrito en Click to Pay, la operación devuelve una lista vacía.

• Use este flujo cuando la aplicación del emisor deba mostrar el estado actual de Click to Pay antes de llamar a Inscribir tarjetas en Click to Pay o Dar de baja tarjetas de Click to Pay.

Considere una lista vacía de perfiles como un resultado funcional válido.

Por lo general, significa que el usuario final es conocido en D1, pero aún no tiene un perfil de Click to Pay.

Manejo de la respuesta

La aplicación del emisor debe esperar los siguientes datos:

• scheme: el directorio de red de pago para el perfil devuelto.

• consumerInfo: los datos actuales del usuario final almacenados en el directorio de Click to Pay.

• cards: la lista de tarjetas asociadas con el perfil de Click to Pay para esa red de pago.

• message: texto opcional de solución de problemas devuelto cuando D1 solo puede proporcionar una respuesta parcial.

Use los datos devueltos para:

• mostrar el estado actual de inscripción en Click to Pay,

• mostrar qué tarjetas están disponibles en cada directorio de red de pago,

• rellenar previamente una interfaz de usuario de actualización de perfil, o

• ayudar al usuario final a elegir la siguiente acción correcta.

No analice ni muestre el campo opcional message al usuario final.

Úselo solo para solucionar problemas.

Gestionar notificaciones push de Click to Pay

A diferencia de la inscripción o la exclusión, recuperar los perfiles de Click to Pay no requiere un flujo dedicado de notificación push.

Esta operación devuelve el resultado actual directamente a la aplicación del emisor. No se espera ningún evento de finalización asíncrona para la propia recuperación del perfil.

Aún puede mantener habilitadas las notificaciones push de Click to Pay en la aplicación del emisor para otras operaciones, como la inscripción o la exclusión. Para obtener detalles de implementación, consulte Gestionar notificaciones push de Click to Pay.

SDK API

El getProfiles (Android / iOS) API está disponible a través del SDK D1.

Android - Kotlin

fun getProfilesC2Pay(d1Task: D1Task) {
    val callback: D1Task.Callback<ProfileResult?> = object : D1Task.Callback<ProfileResult?> {
        override fun onSuccess(data: ProfileResult?) {
            // Obtener perfiles de Click to Pay con éxito
            val profiles: MutableList<Profile?>? = data?.getProfileList()
            val message: String? = data?.getErrorMessage()
            if (!message.isNullOrEmpty()) {
                // registrar el mensaje y puede volver a intentarlo para obtener el perfil completo
            }
            // mostrar todos los perfiles
        }

        override fun onError(exception: D1Exception) {
            // Consulta la sección D1 SDK Integration – Error Management.
        }
    }

    d1Task.getClickToPayService().getProfiles(
        callback
    )
}

iOS

Use los datos de perfil devueltos como origen para la interfaz de usuario de la aplicación del emisor.

No asuma que todas las redes de pago devuelven un perfil para el usuario final.