> 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/nfc-wallet-sdk-android/es/help/knowledge-base/report-nfc-wallet-sdk-issues.md).

# Informar de problemas del SDK NFC Wallet

### Notas generales <a href="#general-notes" id="general-notes"></a>

Para solucionar problemas de forma eficiente, el soporte de Thales necesita los detalles clave desde el principio.

La falta de contexto suele implicar más intercambio de información y una resolución más lenta.

Incluya lo siguiente en cada informe de incidencia:

1. **Versión y tipo de compilación del NFC Wallet SDK**
   * Especifique la versión del SDK.
   * Especifique si utiliza la `dev` o `release` compilación.
2. **Tipo de incidencia**
   * Fallo (incluya un registro del fallo).
   * Error del SDK (incluya los detalles del error).
   * Problema de experiencia de usuario
   * Otro (describa claramente).
3. **Caso de uso**
   * Inicialización o inscripción segura de la cartera (WSE).
   * Tokenización (crear y aprovisionar una tarjeta digital).
   * LCM (suspender, reanudar, eliminar).
   * Otro (describa).
4. **Resumen de la incidencia**
   * Describa qué ocurrió y cuándo comenzó.
   * Para los fallos, adjunte la traza de pila. Asegúrese de que la traza de pila ya esté decodificada por los archivos de mapeo de la aplicación (generados en el momento de la compilación de la aplicación).
   * Para los errores del SDK, incluya:
     * El último método de la API del NFC Wallet SDK llamado.
     * El código y el mensaje de error.
     * Cualquier campo adicional del objeto de error.
   * Para los problemas de experiencia de usuario, adjunte una captura de pantalla o una grabación de pantalla.
5. **Pasos para reproducir**
   * Proporcione una secuencia exacta y numerada.
   * Indique los requisitos previos (configuración, estado de la cuenta de prueba, red, etc.).
   * Aclare si es sistemático (reproducible al 100 %) o intermitente.
6. **Comportamiento esperado**
   * Describa lo que esperaba frente a lo que observó.
   * **Nota**: A veces, una mala interpretación de la funcionalidad de la característica del SDK se informa como una incidencia.
7. **Entorno**
   * Especifique `Preproducción` o `Producción`.
   * Especifique la distribución (pruebas internas, beta o usuarios finales públicos).
8. **Dispositivos afectados y versiones de Android**
   * Enumere los modelos de dispositivos y las versiones de Android en las que se reproduce la incidencia.
   * Enumere los dispositivos en los que la incidencia *no* se reproduce (si se conoce).
9. **Tasa de ocurrencia**
   * Proporcione recuentos y una ventana temporal (por ejemplo, “2 de cada 10 intentos” o “10 veces en 24 horas”).
   * Estime el porcentaje de usuarios finales afectados.
10. **Instancia de cartera y tarjeta digital afectadas**
    * Comparta el id de la cartera (consulte [recuperar el id de la cartera](/nfc-wallet-sdk-android/es/get-started/configuration/4.-initialize-the-nfc-wallet-sdk.md#retrieve-the-wallet-id)).
    * Comparta los identificadores de la tarjeta digital (consulte [id de tarjeta tokenizada e id de tarjeta digital](/nfc-wallet-sdk-android/es/implement-nfc-wallet/manage-digital-cards/display-digital-cards.md#tokenized-card-id-versus-digital-card-id)).
11. **Registros del NFC Wallet SDK**
    * Si puede reproducirlo en un entorno controlado, reproduzca usando una compilación de su **aplicación de cartera digital** que integra el SDK de NFC Wallet `dev` compilación.
    * Siga [Recuperar registros de un dispositivo Android](/nfc-wallet-sdk-android/es/help/knowledge-base/retrieve-logs-from-an-android-device.md).

{% hint style="warning" %}
No comparta PAN, CSC/CVV2, OTP ni otros datos confidenciales del usuario final en los tickets. Use identificadores como `digitalCardID` en su lugar.
{% endhint %}

### Proporcione detalles específicos del caso de uso <a href="#issues-in-certain-use-cases" id="issues-in-certain-use-cases"></a>

Algunos casos de uso necesitan contexto adicional. Añada los detalles siguientes, además de la plantilla estándar.

Evite afirmaciones genéricas como “La tokenización falla” o “el pago no funciona”. Bloquean la clasificación inicial y ralentizan la resolución.

{% tabs %}
{% tab title="Tokenización" %}

1. Confirme el flujo esperado.
   * ¿Es este el **flujo verde** o **flujo amarillo**?
   * ¿Se **inscripción segura de la billetera** completó correctamente?
2. Identifique dónde se detiene el flujo.
   * ¿Cuál es el último método de la API del NFC Wallet SDK llamado?
   * ¿Cuál es el último método de la API del NFC Wallet SDK que se completa correctamente?
3. Comparta el error exacto (si lo hay).
   * ¿Cuáles son el código y el mensaje de error?
   * ¿Qué campos adicionales se devuelven en el objeto de error (si los hay)?
     {% endtab %}

{% tab title="Pago" %}

1. Describa el caso de uso del pago.
   * ¿Es esto **pago sin contacto**, **pago remoto DSRP**, o **pago con código QR**?
   * ¿Qué **red de pago** se ve afectada (por ejemplo, Visa o Mastercard)?
2. Si se trata de un pago sin contacto, comparta la configuración.
   * ¿Está su **aplicación de cartera digital** configurada como la aplicación de pago predeterminada?
   * ¿Qué modo utiliza: doble pulsación, detección de campo o modo manual?
   * ¿Inicia el pago con la tarjeta de pago predeterminada o con una específica `digitalCardID`?
   * ¿Qué perfil se utiliza: tipo tarjeta o flexible **CDCVM**?
3. Comparta el error exacto (si lo hay).
   * ¿Cuáles son el código y el mensaje de error?

{% hint style="info" %}
Para los problemas de pago, incluya los registros del dispositivo tanto para **Tokenización** como para el intento de pago.
{% endhint %}
{% endtab %}
{% endtabs %}

### Plantilla de informe de incidencia <a href="#issue-report-template" id="issue-report-template"></a>

Utilice esta plantilla cuando informe de una incidencia al soporte de Thales.

Reemplace `<PLEASE FILL HERE>` por sus valores. Use `N/D` cuando no sea aplicable.

```
1) Versión y tipo de compilación del NFC Wallet SDK (`dev` o `release`): <PLEASE FILL HERE>

2) Tipo de incidencia (fallo, error del SDK, experiencia de usuario, otro): <PLEASE FILL HERE>

3) Caso de uso (inicialización del SDK, inscripción segura de la cartera, tokenización, pago, LCM, otro): <PLEASE FILL HERE>

4) Resumen de la incidencia: <PLEASE FILL HERE>

5) Pasos para reproducir: <PLEASE FILL HERE>

6) Comportamiento esperado: <PLEASE FILL HERE>

7) Entorno (`Pre-Production` o `Production`) y distribución (pruebas internas, beta, usuarios finales públicos): <PLEASE FILL HERE>

8) Dispositivos afectados y versiones de Android: <PLEASE FILL HERE>

9) Tasa de ocurrencia: <PLEASE FILL HERE>

10) ID de la cartera y `digitalCardID` (si corresponde): <PLEASE FILL HERE>

11) Registros y archivos adjuntos: <PLEASE FILL HERE>
```


---

# 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/nfc-wallet-sdk-android/es/help/knowledge-base/report-nfc-wallet-sdk-issues.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.