> 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-ios/es/help/knowledge-base/how-to-report-issues-with-thales-nfc-wallet-sdk.md). # ¿Cómo informar incidencias con Thales NFC Wallet SDK? ### Notas generales Para solucionar problemas de forma eficiente, el equipo de incorporación y soporte de Thales necesita de entrada los detalles clave. La falta de contexto suele implicar más idas y vueltas y una resolución más lenta. Incluya lo siguiente en cada informe de incidencia: 1. **Versión y variante del SDK NFC Wallet** * Especifique la versión del SDK. * Especifique si usa la `depuración` o `versión de lanzamiento` variante. 2. **Tipo de incidencia** * Cuelgue (incluya un registro de la falla). * 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 monedero (WSE). * Tokenización (crear y aprovisionar una tarjeta digital). * LCM (suspender, reanudar, eliminar). * Otro (describa). 4. **Resumen de la incidencia** * Describa lo que ocurrió y cuándo comenzó. * Para los cuelgues, 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 compilación de la aplicación). * Para los errores del SDK, incluya: * El último método de la API de 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 la 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 una característica del SDK se reporta como una incidencia. 7. **Entorno** * Especifique `PreProd` o `Producción`. * Especifique la distribución * Especifique la audiencia (pruebas internas, usuarios beta, usuarios finales públicos). 8. **Dispositivos afectados y versiones de iOS** * Enumere los modelos de dispositivo y las versiones de iOS en las que se reproduce el problema. * Enumere los dispositivos en los que el problema *no* se reproduce (si se conoce). 9. **Tasa de ocurrencia** * Proporcione recuentos y una ventana temporal (por ejemplo, “2 de 10 intentos” o “10 veces en 24 horas”). * Estime el porcentaje de usuarios finales afectados. 10. **Instancia de monedero o tarjeta digital afectada** * Defina la instancia de monedero afectada (aplicación instalada en un dispositivo específico del usuario final) * Comparta el ID de monedero correspondiente * Use `TSHPay.walletID` para recuperar el identificador del monedero. * Identifique la tarjeta digital afectada (si aplica). * Comparta el identificador correspondiente (`digitalCardID`) cuando sea posible. * Recupere `digitalCardID` de `DigitalCard#digitalCardID`. 11. **registros del NFC Wallet SDK** * Si puede reproducirlo en un entorno controlado, replíquelo con una `depuración` compilación y recopile registros. * Siga [Cómo recuperar registros de un dispositivo iOS](https://thales-dis-dbp.stoplight.io/docs/tsh-hce-ios/824559a389952-how-to-retrieve-logs-from-an-i-os-device). {% hint style="warning" %} No comparta PAN, CSC/CVV2, OTP ni otros datos sensibles del usuario final en los tickets. Use identificadores como `digitalCardID` en su lugar. {% endhint %} ### Proporcione detalles específicos del caso de uso 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 y ralentizan la resolución. {% tabs %} {% tab title="Tokenización" %} 1. Confirme el flujo esperado. * ¿Es este el **flujo verde** o **flujo amarillo**? * ¿Se **la inscripción segura del monedero** completó correctamente? 2. Identifique exactamente dónde se detiene el flujo. * ¿Cuál es el último método de la API de NFC Wallet SDK llamado? * ¿Cuál es el último método de la API de 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 devuelve el objeto de error (si los hay)? {% endtab %} {% tab title="Pago" %} 1. Describa el caso de uso de pago. * ¿Es **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. * ¿Su **aplicación de monedero digital** está configurada como la aplicación de pago predeterminada? * ¿Qué modo está usando: doble clic, detección de campo o modo manual? * ¿Inicia el pago con la tarjeta de pago predeterminada o una específica `digitalCardID`? * ¿Qué perfil se usa: similar a 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 registros del dispositivo tanto para **Tokenización** y el intento de pago. {% endhint %} {% endtab %} {% endtabs %} ### Plantilla de informe de incidencias Utilice la siguiente plantilla al enviar un informe de incidencia al equipo de soporte de Thales TSH Pay SDK. Sustituya los campos de la plantilla, por ejemplo `< COMPLETE AQUÍ >` por los detalles correspondientes o ponga `N/D` si esa información no está disponible. ``` 1) Versión y variante de Thales TSH Pay SDK: < COMPLETE AQUÍ > 2) Tipo de incidencia: < COMPLETE AQUÍ uno de: crash, error del SDK, experiencia de usuario, otro > 3) Caso de uso involucrado: < COMPLETE AQUÍ uno de: inicialización del SDK, inscripción de token, pago, recarga, gestión del ciclo de vida, otro > 4) Resumen de la incidencia: < COMPLETE AQUÍ en texto libre > 5) Pasos de reproducción: < COMPLETE AQUÍ en texto libre > 6) Comportamiento esperado: < COMPLETE AQUÍ en texto libre > 7) Entorno de la aplicación: < COMPLETE AQUÍ el más apropiado de: PPROD/PROD; pruebas internas, beta, públicosssss > 8) Dispositivo afectado: < COMPLETE AQUÍ información del dispositivo, incluida la versión del sistema operativo > 9) Tasa de ocurrencia: < COMPLETE AQUÍ estadísticas sobre la ocurrencia del problema > 10) Referencias de ID de token/ID de monedero: < COMPLETE AQUÍ > 11) Registro: < Adjunte el registro como archivo de texto plano > ``` --- # 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-ios/es/help/knowledge-base/how-to-report-issues-with-thales-nfc-wallet-sdk.md?ask=&goal= ``` `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.