Enviar al monedero digital

Enviar a la billetera digital

Use esta guía para enviar una tarjeta desde la aplicación del emisor a una aplicación de billetera digital usando el SDK D1. Las aplicaciones de billetera compatibles son Google Pay, Samsung Pay y Apple Pay.

Llame a esta API cuando el usuario final toque Agregar a la billetera y el estado de digitalización de la tarjeta sea NOT_DIGITIZED. Para recuperar el estado, consulte Obtener el estado de digitalización de la tarjeta.

Descripción general

La aplicación del emisor llama al SDK D1 addDigitalCardToOEM() API para iniciar el flujo de aprovisionamiento push. El SDK D1 y el backend de D1:

Validan los datos del usuario final y de la tarjeta almacenados en D1.
Preparan la carga útil requerida por la aplicación de billetera y TSP.
Llaman a la aplicación de billetera para iniciar la tokenización.
Devuelven el resultado para que la aplicación del emisor pueda actualizar la interfaz de usuario.

Llame solo a addDigitalCardToOEM() después de que el SDK D1 devuelva NOT_DIGITIZED de getCardDigitizationState().
Para Google Pay en Android, debe implementar onActivityResult para que el resultado de la billetera se reenvíe al SDK D1.
A partir del 10 de junio de 2024, Google Wallet requiere Android 9 o superior.

Flujo

Diagrama de secuencia

Requisitos previos

La cuenta y la tarjeta del usuario final están registradas en D1.
El SDK D1 está inicializado.
La aplicación del emisor ha llamado a la API de inicio de sesión del SDK D1.

High-level sequence for pushing a card to a digital wallet

Integración de la plataforma

Para Android 2.4.0 y posteriores, use D1PushWallet.addDigitalCardToOEM().

//activity: Actividad actual para el aprovisionamiento push OEM.
//cardID: ID de tarjeta recibido.
fun pushCardToWallet_v2_4_0(d1Task: D1Task, cardID: String, activity: Activity) {
    val wallet = OEMPayType.GOOGLE_PAY //GOOGLE_PAY, SAMSUNG_PAY, NONE
    val callback: D1Task.Callback<Any?> = object : D1Task.Callback<Any?> {

        override fun onSuccess(data: Any?) {
            // Maneja el objeto `digitalCardStatus` del servidor.
        }

        override fun onError(exception: D1Exception) {
            // Consulte la sección de gestión de errores de la integración del SDK D1.
        }
    }
    val d1PushWallet : D1PushWallet = d1Task.d1PushWallet
    d1PushWallet.addDigitalCardToOEM(cardID, wallet, activity, callback)
}

// NOTA: Implemente el método `onActivityResult` para reenviar todos los eventos de devolución de llamada al SDK.

// Resultado de la actividad: el método `onActivityResult` se recibe en la app del emisor desde el SDK de GPay y se devuelve al SDK D1 para manejar el resultado.
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    d1Task.handleCardResult(requestCode, resultCode, data);
}

En iOS, use addDigitalCardToOEM(_:viewController:completion:).

let cardID = "" // Obtenido por la aplicación del emisor, por ejemplo desde su backend
let viewController = /* instancia actual de UIViewController que presenta la interfaz de Apple Pay */

d1Task.addDigitalCardToOEM(cardID, viewController: viewController) { error in
    if let error = error {
        // Consulte la sección de gestión de errores de integración del SDK D1
    } else {
        // Actualice la interfaz de usuario, por ejemplo confirme que la tarjeta se agregó a Apple Wallet
    }
}

Para obtener todos los detalles del SDK D1, consulte la referencia de la API.

AnteriorObtener el estado de digitalización de la tarjeta SiguienteExtensión de Apple Wallet

Última actualización hace 2 meses

¿Te fue útil?

//activity: Actividad actual para el aprovisionamiento push OEM.
//cardID: ID de tarjeta recibido.
fun pushCardToWallet_v2_4_0(d1Task: D1Task, cardID: String, activity: Activity) {
    val wallet = OEMPayType.GOOGLE_PAY //GOOGLE_PAY, SAMSUNG_PAY, NONE
    val callback: D1Task.Callback<Any?> = object : D1Task.Callback<Any?> {

        override fun onSuccess(data: Any?) {
            // Maneja el objeto `digitalCardStatus` del servidor.
        }

        override fun onError(exception: D1Exception) {
            // Consulte la sección de gestión de errores de la integración del SDK D1.
        }
    }
    val d1PushWallet : D1PushWallet = d1Task.d1PushWallet
    d1PushWallet.addDigitalCardToOEM(cardID, wallet, activity, callback)
}

// NOTA: Implemente el método `onActivityResult` para reenviar todos los eventos de devolución de llamada al SDK.

// Resultado de la actividad: el método `onActivityResult` se recibe en la app del emisor desde el SDK de GPay y se devuelve al SDK D1 para manejar el resultado.
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    d1Task.handleCardResult(requestCode, resultCode, data);
}