¿Cómo informar problemas con Thales NFC Wallet SDK?

Notas generales

Para solucionar problemas de manera eficiente, el equipo de incorporación y soporte de Thales necesita los detalles clave desde el principio. La falta de contexto suele significar 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 de billetera NFC

   • Especifique la versión del SDK.

   • Especifique si utiliza el depuración o publicación variante.

2. Tipo de incidencia

   • Bloqueo/crash (adjunte un registro de bloqueo).

   • 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 billetera (WSE).

   • Tokenización (crear y aprovisionar una tarjeta digital).

   • LCM (suspender, reanudar, eliminar).

   • Otro (describa).

4. Resumen de la incidencia

   • Describa lo que sucedió y cuándo comenzó.

   • Para bloqueos, adjunte el rastro de la pila. Asegúrese de que el rastro de la pila ya esté decodificado por los archivos de mapeo de la aplicación (generados en el momento de la compilación de la aplicación).

   • Para errores del SDK, incluya:

     • El último método de la API del SDK de billetera NFC llamado.

     • El código y el mensaje de error.

     • Cualquier campo adicional del objeto de error.

   • Para 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 (100% reproducible) 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 informa como un problema.

7. Entorno

   • Especifique PreProducción o Producción.

   • Especifique la distribución

   • Especifique la audiencia (pruebas internas, usuarios beta, usuarios finales públicos).

8. Dispositivos e versiones de iOS afectados

   • Enumere los modelos de dispositivos y las versiones de iOS donde se reproduce el problema.

   • Enumere los dispositivos donde el problema no se reproduce (si se conoce).

9. Tasa de ocurrencia

   • Proporcione recuentos y una ventana de tiempo (por ejemplo, “2 de 10 intentos” o “10 veces en 24 horas”).

   • Estime el porcentaje de usuarios finales afectados.

10. Instancia de billetera o tarjeta digital afectada

• Defina la instancia de billetera afectada (aplicación instalada en un dispositivo específico del usuario final)

  • Comparta el ID de Billetera correspondiente

  • Use TSHPay.walletID para recuperar el identificador de la billetera.

• Identifique la tarjeta digital afectada (si corresponde).

  • Comparta el identificador correspondiente (digitalCardID) cuando sea posible.

  • Recuperar digitalCardID de DigitalCard#digitalCardID.

1. Registros del SDK de billetera NFC

• Si puede reproducir en un entorno controlado, reproduzca con una depuración compilación y recopile registros.

• Siga Cómo recuperar registros desde un dispositivo iOS.

No comparta PAN, CSC/CVV2, OTP u otros datos sensibles del usuario final en los tickets. Use identificadores como digitalCardID en su lugar.

Proporcione detalles específicos del caso de uso

Algunos casos de uso necesitan contexto adicional. Agregue los detalles a continuación, además de la plantilla estándar.

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

Tokenización

1. Confirme el flujo esperado.

   • ¿Es este el flujo verde o flujo amarillo?

   • ¿La inscripción segura de la billetera se completó con éxito?

2. Localice dónde se detiene el flujo.

   • ¿Cuál es el último método de la API del SDK de billetera NFC llamado?

   • ¿Cuál es el último método de la API del SDK de billetera NFC que se completa con éxito?

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 están presentes)?

Pago

Plantilla de informe de incidencias

Utilice la siguiente plantilla al enviar un informe de incidencia al equipo de soporte del SDK Thales TSH Pay.

Reemplace los campos de la plantilla, por ejemplo < POR FAVOR COMPLETE AQUÍ > por los detalles correspondientes o ponga N/A si dicha información no está disponible.

1) Versión y variante del SDK Thales TSH Pay: < POR FAVOR COMPLETE AQUÍ >

2) Tipo de incidencia: < POR FAVOR COMPLETE AQUÍ uno de: crash, error del SDK, experiencia de usuario, otro >

3) Caso de uso involucrado: < POR FAVOR 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: < POR FAVOR COMPLETE AQUÍ en texto libre >

5) Pasos de reproducción: < POR FAVOR COMPLETE AQUÍ en texto libre >

6) Comportamiento esperado: < POR FAVOR COMPLETE AQUÍ en texto libre >

7) Entorno de la aplicación: < POR FAVOR COMPLETE AQUÍ lo más apropiado entre: PPROD/PROD; pruebas internas, beta, público >

8) Dispositivo afectado: < POR FAVOR COMPLETE AQUÍ información del dispositivo incluyendo la versión del SO >

9) Tasa de ocurrencia: < POR FAVOR COMPLETE AQUÍ estadísticas sobre la ocurrencia del problema >

10) Referencias de Token ID/Wallet ID: < POR FAVOR COMPLETE AQUÍ >

11) Registro: < Por favor adjunte el registro como archivo de texto sin formato >