> 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/tokenization/es/integrar-id-and-v-en-la-app.md).

# Integrar ID\&V en la app

Se le podría pedir al Usuario Final, por parte del solicitante del token, que realice una verificación en dos circunstancias esenciales:

1. durante un flujo de tokenización. Tras la solicitud de tokenizar una tarjeta y una decisión posterior de aprobar con un step-up. Esto ocurre en el caso de que se solicite un token para pago por proximidad.
2. en un flujo posterior a la tokenización. Esto ocurre solo para tokens de comercio electrónico. En esencia, el comerciante puede iniciar una solicitud de verificación y, si el emisor aprueba con una solicitud de step-up, se puede usar el método en la aplicación.

En general, el recorrido del usuario se muestra en la siguiente imagen:

<figure><img src="https://content.gitbook.com/content/W6dljaTEEzefPQILRFB7/blobs/umFLV1mnjIqRfuphC4NO/UX%20%20%20Push%20to%20Wallet.svg" alt=""><figcaption><p>Flujo ID&#x26;V de app a app.</p></figcaption></figure>

La billetera digital inicia la aplicación del emisor para la autenticación reforzada por cualquiera de los motivos antes mencionados:

* Paso 1: Elija ID\&V en la app. El usuario final selecciona **Iniciar sesión en la app del banco**.
* Paso 2: Autenticar. El usuario final inicia sesión en la aplicación del emisor.
* Paso 3: Si es necesario, confirme la tarjeta. Muestre los últimos cuatro dígitos del PAN. El usuario final confirma la activación.
* Paso 4: Confirme el resultado de la verificación.
* Paso 5: Regrese a la billetera para confirmar el éxito.

Una vez que el Usuario Final selecciona el método en la app para ID\&V, la aplicación de billetera digital debe redirigir el flujo a la aplicación del emisor.

Para ello, el TSP proporciona la siguiente información de redirección:

* La referencia de la aplicación del emisor (configurada por el emisor en el TSP durante el proceso de incorporación).
* Un payload opaco que describe el motivo de la solicitud de ID\&V.

Esta sección proporciona una guía sobre:

* La información que el emisor debe proporcionar al TSP (metadatos de la aplicación).
* Cómo manejar la llamada de redirección desde la aplicación de billetera digital.

{% hint style="info" %}
Tenga en cuenta que, para obtener información exhaustiva sobre la configuración del TSP, el emisor debe consultar el esquema.
{% endhint %}

El diagrama a continuación muestra, a alto nivel, los principales pasos implicados en este tipo de interacción entre una billetera digital y la aplicación del emisor:

<figure><img src="https://content.gitbook.com/content/W6dljaTEEzefPQILRFB7/blobs/MeySOtsF8zGk5kBacCgt/Integrate%20in%20app%20ID&amp;V%20for%20xPay%20Wallets.svg" alt=""><figcaption><p>Flujo de redirección de ID&#x26;V en la app para billeteras xPay.</p></figcaption></figure>

1. Durante el proceso de incorporación, el emisor configura los metadatos de la aplicación en el TSP.
2. Durante la tokenización, cuando se requiere autenticación step-up, el TSP proporciona los siguientes datos junto con el tipo de método:
   1. referencia de la aplicación del emisor
   2. payload opaco
3. La aplicación de billetera digital usa la referencia de la aplicación del emisor para abrir la aplicación del emisor. Pasa el payload opaco en la llamada.
4. La aplicación del emisor analiza el payload opaco para entender la solicitud. Luego solicita al Usuario Final que ingrese las credenciales.
5. La aplicación del emisor verifica las credenciales.
6. La aplicación del emisor devuelve el resultado de la verificación al backend del emisor.
7. El backend del emisor informa el resultado al TSP.

La carga opaca es esencialmente una cadena base64 que codifica un objeto JSON formateado por el esquema TSP.

El contenido de este objeto no es sensible, por lo que la única operación que debe realizar el emisor es decodificar el formato base64 e interpretar los campos JSON.

Los campos permiten al emisor identificar el contexto para el que se requiere la verificación.

A continuación, algunos ejemplos extraídos de la documentación del esquema.

{% hint style="info" %}
Para obtener todos los detalles, se recomienda consultar la documentación dedicada de los esquemas.
{% endhint %}

### Visa

Caso de uso: tokenización

```json
{
  "panReferenceID":"V-3815023863409817870482",
  "tokenRequestorID":"42301999123",
  "tokenReferenceID":"DNITHE381502386342002358",
  "panLast4":"1234",
  "deviceID":"DEiOiJBMjU2R_0NNS1-ciLCJiI",
  "walletAccountID":"AiOiJBMjU-2_R0NNS1ciLCJiI6"
}
```

Caso de uso: vinculación de dispositivo

```json
{
 "panReferenceID": "V38202107121853123XXXXX",
 "tokenRequestorID": "400100XXXXX",
 "tokenReferenceID": "DNITHE3820226686801XXXXX",
 "panLast4": "6301",
 "walletAccountID": "AWMTE9aPXFBM3yddqpE_kzf-",
 "deviceID": "0ff81e66b98e0e3f7d91b76b",
 "deviceIndex": "1",
 "reasonCode": "TOKEN_DEVICE_BINDING"
 }
```

Caso de uso: verificación del titular de la tarjeta

```json
{"panReferenceID":"V38202107121853123XXXXX",
"tokenRequestorID":"400100XXXXX",
"tokenReferenceID":"DNITHE3820226686801XXXXX",
"panLast4":"6301",
"walletAccountID":"AWMTE9aPXFBM3yddqpE_kzf-",
"deviceID": null,
"deviceIndex": null,
"reasonCode": "CARDHOLDER_STEPUP",
"lifeCycleTraceID": "773871594125753"
}
```

### Mastercard

Caso de uso: tokenización

```json
{
  "paymentAppProviderId": "123456789",
  "paymentAppInstanceId": "123456789",
  "tokenUniqueReference": "DWSPMC000000000fcb2f4136b2f4136a0532d2f4136a0532",
  "accountPanSuffix": "6789",
  "accountExpiry": "1018"
}
```

Caso de uso: vinculación de dispositivo

```json
{
 "paymentAppProviderId" : "23404332",
 "authenticationCorrelationId" : "23aerkeskew48943040",
 "tokenUniqueReference" : "23430iejfoijwe0404",
 "accountPanSuffix": "2345",
 "accountExpiry" : "1222"
}
```

Opcionalmente, el emisor puede apoyarse en D1 SDK para analizar el objeto JSON proporcionado por la cartera digital. Esto puede utilizarse en todos los casos en los que la cartera digital no manipule el objeto JSON de alguna manera. Por ejemplo, esto no puede utilizarse para Apple Pay. Consulte los detalles en la sección Integración con Apple Pay.

{% hint style="info" %}
**Nota**

La integración de D1 SDK implica tarifas adicionales. Para más detalles, consulte con su contacto en Thales.
{% endhint %}

#### fragmento de código

### Asignación de los campos con los campos D1

Se aplican las siguientes reglas de asignación:

D1 `digitalCardId`:

* Visa: `tokenReferenceID`.
* Mastercard: `tokenUniqueReference`.

Casos de uso posteriores a la tokenización:

D1 `authenticationId`:

* Vinculación de tokens
  * Visa: `deviceIndex`
  * Mastercard: `authenticationCorrelationId`
* Verificación del titular de la tarjeta
  * Visa: `lifeCycleTraceId`


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.payments.thalescloud.io/tokenization/es/integrar-id-and-v-en-la-app.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
