Enviar a la billetera digital

Enviar a la billetera digital

Utilice esta guía para enviar una tarjeta desde la aplicación del emisor a una aplicación de billetera digital mediante 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 Añadir a la billetera y el estado de digitalización de la tarjeta es 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 provisión push. El SDK D1 y el backend D1:

• Validan al usuario final y los datos de la tarjeta almacenados en D1.
• Preparan la carga útil requerida por la aplicación de billetera y el 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.

• A partir del SDK D1 4.5.0, el SDK admite Google Unified Push Provisioning (UPP), la provisión de tarjetas de co-badge y Bounce Provisioning.
• UPP permite que el FPAN del usuario final se guarde en su Cuenta de Google para pagos en línea cuando la tokenización se inicia desde la aplicación del emisor.
• Las tarjetas de co-badge elegibles pueden añadirse a Google Wallet con tokens separados para los esquemas de pago internacional y nacional.
• Bounce Provisioning redirige al usuario final desde Google Wallet al flujo de provisión push de la aplicación del emisor. Para habilitarlo, establezca options en 1 en addDigitalCardToOEM() . Para más detalles, consulte la sección provisión Bounce de Google Wallet.
• Estas funciones solo son compatibles con teléfonos inteligentes Android físicos.

Flujo

Diagrama de secuencia

Requisitos previos

• El usuario final y la tarjeta están registrados 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.

Secuencia de alto nivel para enviar una tarjeta desde la aplicación del emisor a una billetera digital mediante el SDK D1.

Integración de plataforma

Android >= 4.4.0

fun addDigitalCardToOEM(
    d1Task: D1Task,
    cardID: String,
    wallet: OEMPayType,
    options: Int, // Desde el SDK 4.5.0, establezca options en '1' para habilitar Bounce Provisioning. Todos los demás valores enteros se ignoran.
    activity: FragmentActivity
) {
    activity.lifecycleScope.launch {
        try {
            val result = d1Task.pushProvisioningService.addDigitalCardToOEM(
                cardID,
                wallet,
                activity,
                options
            ).await()
            if (result is GoogleCardSavedStatusResult) {
                val googlePayStatusCode = result.statusCode
                val cardSaved = result.isSaved

                // Use el estado de Google Pay para la resolución de problemas.
                // Use cardSaved para actualizar la interfaz de usuario de la aplicación del emisor.
                // No utilice este resultado para determinar el resultado de la tokenización.
            } else {
                // Samsung Pay se completa correctamente con un resultado nulo.
            }
        } catch (exception: D1Exception) {
            val cardSavedResult = exception.additionalData as? GoogleCardSavedStatusResult
            if (cardSavedResult != null) {
                val googlePayStatusCode = cardSavedResult.statusCode
                val cardSaved = cardSavedResult.isSaved

                // Google Pay puede devolver información de estado de tarjeta guardada con un error.
                // Úsela para la resolución de problemas y la gestión de la interfaz de usuario de la aplicación del emisor.
                // No utilice este resultado para determinar el resultado de la tokenización.
            }
            // Consulte la sección de gestión de errores de integración del SDK D1
        }
    }
}

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

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

Android < 4.4.0

Para Android v4.3.0 y anteriores, use D1PushWallet.addDigitalCardToOEM().

//activity: Actividad actual para la provisión push de OEM.
//cardID: ID de la tarjeta recibida.
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?) {
            // Gestiona la provisión exitosa
        }

        override fun onError(exception: D1Exception) {
            // Consulte la sección de gestión de errores de 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 actividad: el método `onActivityResult` se recibe en la aplicación del emisor desde el SDK de GPay y se reenvía al SDK D1 para gestionar el resultado.
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    d1Task.handleCardResult(requestCode, resultCode, data);
}

iOS >= 4.4.0

let cardID = "" // obtenido, por ejemplo, del servidor
let viewController = UIViewController() // la página desde la que se presentará la interfaz de usuario de Apple Pay
do {
    let service = try d1Task.pushProvisioningService()
    try await service.addDigitalCardToOEM(cardID, viewController: viewController)
    // Continúe con los flujos posteriores, por ejemplo, actualice la interfaz de usuario
} catch let d1Error as D1Error {
    // Consulte la sección de gestión de errores de integración del SDK D1
} catch let error {
    // Maneje otros errores
}

iOS < 4.4.0

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 usuario 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 añadió a Apple Wallet
    }
}

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