Darse de baja mediante el SDK de D1

Resumen

Esta página explica cómo la aplicación del emisor puede darse de baja de Click to Pay mediante el SDK D1.

El SDK D1 proporciona dos API de baja:

• optOutCard elimina una tarjeta de Click to Pay.

• optOutConsumer elimina todas las tarjetas del usuario final de Click to Pay.

Utiliza estos flujos del SDK cuando quieras que el usuario final inicie la baja directamente desde la aplicación del emisor mientras D1 orquesta las interacciones del backend con los directorios de Click to Pay y la red de pago.

Enlaces rápidos

• Dar de baja tarjetas de Click to Pay

• Recuperar perfiles con el SDK D1

• Inscribir tarjetas con el SDK D1

• Actualizar perfiles con el SDK D1

Elige la API de SDK adecuada

optOutCard

Usa optOutCard cuando el usuario final quiere eliminar una tarjeta específica de Click to Pay.

Esta opción mantiene sin cambios las demás tarjetas inscritas.

optOutConsumer

Usa optOutConsumer cuando el usuario final quiere eliminar el perfil completo de Click to Pay.

Esta opción elimina todas las tarjetas inscritas en Click to Pay para ese usuario final.

Flujo

El siguiente diagrama muestra el flujo general de baja basado en el SDK:

Diagrama de secuencia

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

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

Puntos clave

• Ambas operaciones son asíncronas.

• El resultado inmediato contiene un estado de SUCCESSFUL o PENDING, además de un operationID.

• Usa Recuperar perfiles con el SDK D1 antes de la baja cuando la aplicación del emisor debe mostrar el estado actual de Click to Pay.

• optOutCard elimina una tarjeta digital del lado de la red de pago.

• optOutConsumer elimina el perfil completo de Click to Pay para el usuario final en todas las tarjetas inscritas.

• El resultado final también se puede seguir a través del endpoint Get Operation en el resumen de la API D1 o a través de las notificaciones D1.

Los diagramas ilustran el flujo de baja iniciado desde la aplicación del emisor.

optOutConsumer sigue el mismo patrón del SDK que optOutCard, pero se aplica a todas las tarjetas vinculadas al usuario final.

Gestionar notificaciones push de Click to Pay

Consulta Gestionar notificaciones push de Click to Pay en la documentación de inscripción mediante el SDK D1 para conocer los detalles de implementación.

API del SDK para optOutCard

Desde el SDK D1 4.2.0, optOutCard (Android / iOS) está disponible a través del SDK D1.

Usa esta API cuando el usuario final quiera darse de baja solo de una tarjeta específica.

Android - Kotlin

fun optOutClick2Pay(d1Task: D1Task, cardID: String) {

    val callback: D1Task.Callback<Status?> =
        object : D1Task.Callback<Status?> {
            override fun onSuccess(data: Status?) {
                // Baja de Click to Pay correcta
                val status: Status? = data
                val operationID = data?.operationID
            }

            override fun onError(exception: D1Exception) {
                // Consulta la sección D1 SDK Integration – Error Management.
            }
        }
    d1Task.getClickToPayService().optOutCard(
        cardID,
        callback
    )
}

iOS

Usa optOutCard cuando la aplicación del emisor presenta una lista de tarjetas y el usuario final selecciona una tarjeta para eliminar.

API del SDK para optOutConsumer

Desde el SDK D1 4.3.0, optOutConsumer (Android / iOS) está disponible a través del SDK D1.

Usa esta API cuando el usuario final quiera darse de baja de todas las tarjetas de Click to Pay en una sola acción.

Android - Kotlin

fun optOutConsumerClick2Pay(d1Task: D1Task) {
    val callback: D1Task.Callback<Status?> =
        object : D1Task.Callback<Status?> {
            override fun onSuccess(data: Status?) {
                // Baja de Click to Pay correcta
                val status: Status? = data
                val operationID = data?.operationID
            }

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

iOS

Usa optOutConsumer cuidadosamente.

Esta acción elimina todas las tarjetas de Click to Pay del usuario final.