> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets/push-to-the-digital-wallet.md).

# Enviar a la billetera digital

## Enviar a la billetera digital

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

Llama 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, consulta [Obtener el estado de digitalización de la tarjeta](/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets/get-the-card-digitization-state.md).

### Descripción general

La aplicación emisora llama al SDK D1 `addDigitalCardToOEM()` API para iniciar el flujo de provisionamiento por 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 TSP.
* Llaman a la aplicación de billetera para iniciar la tokenización.
* Devuelven el resultado para que la aplicación emisora pueda actualizar la interfaz de usuario.

{% hint style="info" %}

* Llama solo a `addDigitalCardToOEM()` después de que el SDK D1 devuelva `NOT_DIGITIZED` de `getCardDigitizationState()`.
* Para Google Pay en Android, debes 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](https://developers.google.com/wallet/docs/release-notes?utm_source=chatgpt.com#June_04_2024) requiere Android 9 o superior.
  {% endhint %}

{% hint style="warning" %}

* A partir del SDK D1 4.5.0, el SDK admite Google Unified Push Provisioning (UPP), el aprovisionamiento de tarjetas 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 emisora.
* Las tarjetas co-badge elegibles se pueden añadir a Google Wallet con tokens separados para los esquemas de pago internacional y doméstico.
* Bounce Provisioning redirige al usuario final desde Google Wallet al flujo de aprovisionamiento por push de la aplicación emisora. Para habilitarlo, establece `options` a `1` en `addDigitalCardToOEM()` . Para más detalles, consulta la sección [aprovisionamiento bounce de Google Wallet](/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets/google-wallet-bounce-provisioning.md).
* Estas funciones solo son compatibles en smartphones Android físicos.
  {% endhint %}

### Flujo

<figure><img src="https://4070583847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWDlYTPaq4dNHuiWtf8ux%2Fuploads%2FR1nYY9n0Q43IruIuDZfZ%2FFlow%20-%20%20Push%20to%20the%20digital%20wallet.svg?alt=media&amp;token=3007243c-1e03-40da-bd6b-3247d2a3e2a2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4070583847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWDlYTPaq4dNHuiWtf8ux%2Fuploads%2FvB0wAgAIlF7be9chbsVS%2FFlow%20-%20%20Push%20to%20the%20digital%20wallet%20-%202.svg?alt=media&amp;token=b1f1187c-dc2f-486d-8b3a-02aa94d06105" alt=""><figcaption></figcaption></figure>

#### Diagrama de secuencia

**Requisitos previos**

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

<figure><img src="https://4070583847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWDlYTPaq4dNHuiWtf8ux%2Fuploads%2Fgit-blob-023a95e364ff873ee5df368730eb7f29de3ddc7f%2FSequence%20Diagram%20-%20%20Push%20to%20the%20digital%20wallet.svg?alt=media" alt="High-level sequence for pushing a card to a digital wallet"><figcaption><p>Secuencia de alto nivel para enviar una tarjeta desde la aplicación emisora a una billetera digital utilizando el SDK D1.</p></figcaption></figure>

### Integración de la plataforma

{% tabs %}
{% tab title="Y > 4.4.0" %}

```kotlin
fun addDigitalCardToOEM(
    d1Task: D1Task,
    cardID: String,
    wallet: OEMPayType,
    options: Int, // Desde el SDK 4.5.0, establece 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

                // Usa el estado de Google Pay para la solución de problemas.
                // Usa cardSaved para actualizar la interfaz de usuario de la aplicación emisora.
                // No uses 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.
                // Úsala para la solución de problemas y el manejo de la interfaz de usuario de la aplicación emisora.
                // No uses este resultado para determinar el resultado de la tokenización.
            }
            // Consulta la sección Integración del SDK D1 – Gestión de errores
        }
    }
}

// NOTA: Implementa 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 aplicación emisora desde el SDK de GPay y se devuelve al SDK D1 para procesar el resultado.
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    d1Task.handleCardResult(requestCode, resultCode, data);
}
```

{% endtab %}

{% tab title="Y = 4.4.0" %}

```kotlin
fun addDigitalCardToOEM(
    d1Task: D1Task,
    cardID: String,
    wallet: OEMPayType,
    options: Int,
    activity: FragmentActivity
) {
    activity.lifecycleScope.launch {
        try {
            val result = d1Task.pushProvisioningService.addDigitalCardToOEM(
                cardID,
                wallet,
                activity,
                options
            ).await()
            // éxito
        } catch (exception: D1Exception) {
            // Consulta la sección Integración del SDK D1 – Gestión de errores
        }
    }
}

// NOTA: Implementa 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 aplicación emisora desde el SDK de GPay y se devuelve al SDK D1 para procesar el resultado.
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    d1Task.handleCardResult(requestCode, resultCode, data);
}
```

{% endtab %}

{% tab title="Y < 4.4.0" %}
Para Android v4.3.0 y anteriores, usa `D1PushWallet.addDigitalCardToOEM()`.

```kotlin
//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?) {
            // Gestiona el aprovisionamiento exitoso
        }

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

// NOTA: Implementa 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 aplicación emisora desde el SDK de GPay y se devuelve al SDK D1 para procesar el resultado.
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    d1Task.handleCardResult(requestCode, resultCode, data);
}
```

{% endtab %}

{% tab title="iOS >= 4.4.0" %}

```swift
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úa con los flujos posteriores, por ejemplo, actualizar la interfaz de usuario
} catch let d1Error as D1Error {
    // Consulta la sección Integración del SDK D1 – Gestión de errores
} catch let error {
    // Gestiona otro error
}
```

{% endtab %}

{% tab title="iOS < 4.4.0" %}

```swift
let cardID = "" // Obtenido por la aplicación emisora, por ejemplo, desde tu 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 {
        // Consulta la sección de gestión de errores de la integración del SDK D1
    } else {
        // Actualiza la interfaz de usuario, por ejemplo, confirma que la tarjeta se añadió a Apple Wallet
    }
}
```

{% endtab %}
{% endtabs %}

Para obtener todos los detalles del SDK D1, consulta la [referencia de API](/push-provisioning/es/integrate-the-d1-sdk/api-reference.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets/push-to-the-digital-wallet.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.