Modo de depuración y registros

La pasarela PowerTranz incluye un registro completo para ayudar a diagnosticar problemas de pago. Esta guía explica cómo habilitar el modo de depuración e interpretar los archivos de registro.

Habilitar el modo de depuración

Para habilitar el registro detallado para la puerta de enlace PowerTranz:

1. Ir a WooCommerce → Configuración → Pagos
2. Haga clic Administrar junto a PowerTranz
3. Desplácese hasta el Registro de depuración opción (pestaña «Avanzado»)
4. Marque la casilla para Habilitar registro
5. Haga clic Guardar cambios

Importante: Habilite el modo de depuración solo cuando solucione problemas. Desactívelo en producción para evitar saturar su servidor con archivos de registro.

Acceso a los archivos de registro

WooCommerce almacena todos los registros de la pasarela en una ubicación central:

1. Ir a WooCommerce → Estado → Registros
2. En el menú desplegable, seleccione los archivos que comienzan por powertranz-
3. Haga clic Ver para ver el contenido del registro

Los archivos de registro se nombran con la fecha, por ejemplo: powertranz-2024-01-15-abc123.log

¿Qué se registra?

Cuando el modo de depuración está habilitado, la puerta de enlace registra:

• Solicitudes de API – Datos enviados a PowerTranz (los datos de la tarjeta están ocultos).
• Respuestas API – Respuestas completas de los servidores PowerTranz.
• Eventos 3D Secure – Solicitudes y resultados de autenticación.
• Mensajes de error – Información detallada sobre los errores con códigos de respuesta.
• Datos de webhook/retroalimentación – Notificaciones entrantes de PowerTranz
• Operaciones con tokens – Tokenización de tarjetas y transacciones con tarjetas guardadas.

Comprensión de las entradas de registro

Una entrada típica del registro tiene este aspecto:

2024-01-15T10:30:45+00:00 INFO PowerTranz Auth Request: Order #1234
  2024-01-15T10:30:46+00:00 INFO PowerTranz Response: Approved (ResponseCode: 00)
  2024-01-15T10:30:46+00:00 INFO Transaction ID: PTZ-987654321

Elementos clave a tener en cuenta:

• Marca de tiempo – Cuando ocurrió el evento
• Nivel de registro – INFORMACIÓN, ADVERTENCIA o ERROR
• Mensaje – Descripción de lo sucedido.
• Código de respuesta – El código devuelto por PowerTranz.
• Identificador de transacción – Identificador único de la transacción.

Patrones de registro comunes

Transacción exitosa

INFO PowerTranz Auth Request: Order #1234
  INFO PowerTranz Response: Approved (ResponseCode: 00)
  INFO Order #1234 payment complete. Transaction ID: PTZ-987654321

Transacción rechazada

INFO PowerTranz Auth Request: Order #1234
  WARNING PowerTranz Response: Declined (ResponseCode: 05)
  WARNING Order #1234 payment failed: Do Not Honour

Flujo 3D Secure

INFO 3DS Authentication Required for Order #1234
  INFO 3DS Challenge URL received, redirecting customer
  INFO 3DS Callback received for Order #1234
  INFO 3DS Authentication successful (ECI: 05)
  INFO PowerTranz Auth Request: Order #1234 (3DS Authenticated)

Error de conexión API

ERROR PowerTranz API Request Failed: Order #1234
  ERROR cURL error 28: Connection timed out after 30000 milliseconds

Solución de problemas con registros

Al diagnosticar problemas:

1. Busca el número de pedido. – Busque en el registro el ID de pedido específico.
2. Verifique el código de respuesta. – Consulte la documentación sobre códigos de error.
3. Busque entradas con el indicador ERROR. – Estos indican problemas que requieren atención.
4. Revisa la secuencia. – Asegúrate de que se hayan realizado todos los pasos previstos en el orden correcto.
5. Revisa las marcas de tiempo. – Los intervalos largos pueden indicar problemas de tiempo de espera.

Ubicación del archivo de registro en el servidor

Si necesita acceder a los registros directamente a través de FTP o SSH, estos se almacenan en:

wp-content/uploads/wc-logs/powertranz-YYYY-MM-DD-hash.log

Consideraciones de seguridad

• Los datos confidenciales se ocultan. – Nunca se registran los números completos de las tarjetas.
• Desactivar en producción – Solo habilitar cuando se esté solucionando un problema de forma activa.
• Borrar registros antiguos – Eliminar periódicamente los archivos de registro antiguos.
• Proteja la carpeta de registros – Asegúrate de que tu wc-logs La carpeta no es de acceso público.

Compartir registros con el servicio de asistencia

Cuando se comunique con el servicio de asistencia, incluya las entradas de registro pertinentes. Antes de compartir:

1. Copia solo las entradas relacionadas con la transacción problemática.
2. Incluye el rango completo de marcas de tiempo.
3. Anote el número de pedido y la hora aproximada en que se produjo el problema.
4. Verifique que no se incluyan datos confidenciales de los clientes.

Siguiente: Preguntas frecuentes – Respuestas a preguntas frecuentes sobre la pasarela.