Investigar la actividad de las transacciones
Rastrear un pedido desde la creación hasta la enrutación, la autenticación, el pago, la captura, la anulación o el reembolso en DEUNA Admin.
En esta página
Utilice la actividad de las transacciones cuando un pedido está pendiente, rechazado, retrasado o se comporta de manera diferente a la integración con el comerciante. DEUNA Admin combina un historial de pagos a nivel empresarial con registros de solicitudes y respuestas técnicas, para que los equipos de operaciones e integración puedan investigar la misma transacción sin cambiar de herramienta.
La actividad de las transacciones es de solo lectura. Ver un evento no vuelve a intentar una solicitud, modifica un pedido o contacta a un procesador de pagos.
Antes de comenzar#
Tu rol debe incluir Sección de "Visualizar pedidos" Permiso. Confirme el comerciante y el entorno seleccionados antes de realizar la búsqueda; los registros están restringidos a ese contexto.
Debe tener al menos un identificador disponible:
- ID del pedido o token de pedido
- Transaction ID
- Correo electrónico del cliente, cuando lo permita su política de privacidad
- Fecha de creación aproximada
Si no puede abrir Pagos > Órdenes, solicite a un usuario administrador que revise Roles y permisos.
Elija la vista adecuada#
Los detalles del pedido proporcionan dos superficies de investigación relacionadas. Comience con Visualizar el historial, y luego utilice Técnico cuando necesite el intercambio subyacente.
| Superficie | Lo mejor para | Qué muestra |
|---|---|---|
| Visualizar el historial | Comprender el ciclo de vida del pago | Creación y actualizaciones de pedidos, creación y cambios de estado de pagos, enrutamiento, 3DS y eventos de fraude, con los campos relevantes para cada evento. |
| Técnico | Diagnosticar un intercambio entre integración o proveedor | Eventos de transacción registrados, método HTTP y destino, código de respuesta, datos de solicitud y respuesta, marcas de tiempo y identificadores disponibles de solicitud, rastreo y span. |
| Registros de Actividad | Registro de acciones realizadas por usuarios de administrador | Quién modificó una configuración o realizó una acción de administrador. Los registros de actividad no representan el seguimiento de la ejecución del pago. |
Acceder a la actividad de las transacciones#
- Inicie sesión en DEUNA Admin.
- Seleccione el comerciante y el entorno asociados a la transacción.
- Acceda a Pagos > Órdenes.
- Busque por ID de pedido o correo electrónico, o utilice los filtros de fecha y pago para reducir la lista.
- Abra el menú de acciones de fila y seleccione Ver detalles.
- Para el resumen del ciclo de vida, seleccione Visualizar el historial. Para consultar la actividad de las transacciones, abra Técnico.
Si el pedido no tiene eventos técnicos registrados, Técnico muestra Sin actividad técnica. Esto por sí solo no identifica la causa ni el resultado del pago.
Siga el historial de pagos#
Seleccione Visualizar el historial desde el encabezado de detalles del pedido. El historial se presenta como una línea de tiempo, con el evento más reciente primero.
Los campos exactos dependen del evento:
| Evento | Evidencia que puede esperar |
|---|---|
| Pedido creado | Monto inicial, moneda y estado del pedido. |
| Pedido actualizado | Estado actual del pedido y del pago. |
| Pago creado | Monto y moneda del pago. |
| Estado del pago actualizado | Estado del pago y detalles del procesador, autorización, captura, reembolso o error aplicables. |
| Ruta generada | Regla y ruta aplicadas, así como el proveedor de pago o fraude representado por esa ruta. Una decisión de enrutamiento puede crear más de una entrada en la línea de tiempo. |
| 3DS actualizado | Estado de autenticación, proveedor de 3DS y un código o mensaje de error en caso de que se haya reportado alguno. |
| Análisis de fraude | Información disponible del proveedor, decisión, riesgo, evaluación o modo de "shadow mode". |
No considere un evento intermedio como el resultado financiero final. Por ejemplo, la autenticación exitosa de 3DS permite continuar con el procesamiento del pago, pero no significa que el pago haya sido autorizado o capturado.
Inspeccionar eventos técnicos#
Acceda a Técnico. Esta vista tiene dos áreas: Actividad y Datos.
Actividad técnica en DEUNA Admin. Todos los valores de comercio, usuario, proveedor, identificador, tiempo y payload de este ejemplo son ficticios.
Qué contiene la vista técnica
| Área | Qué se muestra allí | como usarlo |
|---|---|---|
| Contexto del pedido | Importe total del pedido, estado del pedido y del pago, última actualización, token del pedido, ID del pedido y ID del cliente. | Verifique que ha abierto el pedido correcto y el entorno antes de interpretar un evento. |
| Controles de actividad | Conteo de eventos registrados, control de ordenación, búsqueda de nombres de eventos y tres modos de agrupación: Ninguno, Solicitud y Seguimiento. | Reduce un largo rastro de transacción a los eventos relacionados con la operación que está investigando. |
| Encabezado de grupo | Tipo de grupo, ID de solicitud o ID de rastro abreviado, número de eventos y la suma del tiempo de ejecución registrado para los eventos en ese grupo. | Expanda o colapse los puntos de control relacionados y compare una solicitud o rastro con otro. |
| Punto de control de actividad | Etiqueta de código de respuesta cuando esté disponible, nombre del evento, hora de creación del evento y marca de tiempo del registro. | Seleccione el punto de control que mejor coincida con la etapa fallida, retrasada o inesperada. |
| Resumen de intercambio | Método HTTP o de protocolo, destino, ID de solicitud, ID de rastro y ID de Span. Los identificadores disponibles incluyen controles de copia. | Correlacione el evento con los registros del comerciante, evidencia del proveedor o una investigación de DEUNA Support. |
| Visualizador de datos | Pestañas de Solicitud y Respuesta, indicador de código de respuesta, valor de tiempo transcurrido (si está disponible), y datos de carga formateados con control de copia. | Compare los datos de salida con el resultado devuelto. Copie solo la evidencia mínima y segura requerida. |
El visualizador de payload mantiene visibles los nombres de objetos y campos para que pueda inspeccionar la estructura del intercambio. Los valores y anidamientos varían según el evento y el proveedor. Un campo mostrado en el ejemplo no está garantizado que aparezca en cada transacción.
Leer un evento
- Seleccionar un evento en Actividad. En dispositivos móviles, expanda el evento.
- Revisar el nombre del evento y la marca de tiempo.
- Comparar el método HTTP, el destino y el código de respuesta con la operación que se esperaba.
- Cambiar entre Solicitud y Respuesta en Datos.
- Registrar el ID de la Solicitud, el ID de Seguimiento o el ID de Span cuando estén presentes.
Cuando un evento tiene una 4xx respuesta, DEUNA Admin puede mostrarla mensaje de error arriba del payload. Los demás códigos de respuesta siguen visibles en el evento y en el panel de datos.
El código de respuesta describe la transacción técnica, no necesariamente el resultado final del pago. Antes de completar un pedido, compare el código con Estado del pago, Visualizar el historialy las notificaciones de estado asíncronas.
Eventos producidos durante un flujo de pedidos
La actividad disponible depende del camino que siguió la transacción. Los grupos comunes incluyen:
| Etapa | Ejemplos visibles en la Actividad | Qué inspeccionar |
|---|---|---|
| Orden | Se creó un nuevo pedido; el pedido se actualizó | Identificadores del pedido y el estado devuelto a la integración del comerciante. |
| Enrutamiento | Generar la ruta de pago | La ruta seleccionada y las interacciones con el proveedor que la siguen. |
| Pago | Generar pago; solicitar autorización | Solicitar el importe y la moneda, respuesta del procesador y el estado resultante del pago. |
| Autenticación | Evaluación 3DS iniciada, desafiada, actualizada, completada o fallida | Si se requirió la acción del cliente y si el procesamiento del pago continuó posteriormente. |
| Verificación de la dirección | Validación AVS, supresión o reversión | Resultado de validación normalizado y la acción de pago que siguió. |
| fraude | Generar análisis del motor de prevención de fraudes; evaluación en segundo plano | Resultado del proveedor y si la transacción continuó al procesamiento o revisión del pago. |
| Operaciones post-pago | Captura, captura parcial, reembolso, reembolso parcial, cancelación, o solicitud de reversión | Importe y identificador de la operación, respuesta y el posterior evento de estado de pago que confirma el resultado. |
Algunos eventos registran que una etapa ocurrió, pero no contienen el cuerpo de la solicitud o la respuesta. La disponibilidad del payload varía según la operación y el proveedor.
Agrupar y buscar el registro#
En ActividadUtilice los siguientes controles para reducir la longitud de la traza:
- Ninguno muestra cada evento en una lista plana.
- Solicitud agrupa eventos que comparten un ID de Solicitud. Úsalo para seguir el trabajo iniciado por una solicitud entrante.
- Registro agrupa eventos que comparten un ID de Registro. Úsalo para seguir una transacción a través de los pasos de procesamiento relacionados.
- Buscar evento filtra por el nombre del evento mostrado.
- Ordenar actividad invierte el orden de los eventos.
Cuando un evento no tiene valor para el identificador del grupo seleccionado, DEUNA Admin lo coloca en Huérfano. El evento aún puede ser útil si su ID de transacción, marca de tiempo y eventos adyacentes coinciden con la ventana de incidente.
Investigar un pago o transferencia fallida o retrasada#
Siga este orden para no confundir un error técnico intermedio con el resultado final:
- Verifique el entorno, el estado actual del pedido, el estado actual del pago, Order IDy Transaction ID.
- Acceda a Visualizar el historial y identificar el último evento del ciclo de vida.
- Acceda a Técnico y agrupar por Registro.
- Encontrar el pago, la ruta, la autenticación, la prevención de fraude o el evento posterior al pago correspondiente.
- Comparar su código de respuesta y datos de respuesta con el siguiente evento en el rastreo.
- Verificar si una actualización de estado posterior recuperó el pago, lo movió a otro proveedor o confirmó un fallo final.
- Comparar el estado final de DEUNA con el estado recibido a través de su webhook de pago.
Para una devolución, busque la referencia pública de códigos de error utilizando el código de error de DEUNA. Los códigos y mensajes específicos del proveedor deben interpretarse utilizando la documentación correspondiente del proveedor.
Preparar pruebas para el soporte#
Cuando necesite que el soporte de DEUNA investigue, proporcione la evidencia mínima requerida:
- Comercio y entorno
- ID del pedido o token de pedido
- Transaction ID
- Marca de tiempo UTC y ventana de incidencia
- Nombre del evento y código de respuesta mostrados
- ID de solicitud, ID de rastreo e ID de Span cuando estén disponibles
- Estado actual del pedido y del pago
- Comportamiento esperado y comportamiento observado
Solo envíe el payload completo cuando el Soporte lo solicite a través de un canal aprobado.
Límites y recuperación#
- La actividad de transacción es un registro de observabilidad, no un control de reproducción o reintento.
- No todas las etapas producen un cuerpo de solicitud y respuesta.
- Los eventos pueden llegar después de la solicitud inicial cuando un proveedor informa de un resultado asíncrono.
- La ausencia de actividad no determina si un proveedor procesó la transacción.
- El estado actual del pago o del pedido es la vista administrativa definitiva; utilice webhooks y la respuesta de la API correspondiente para el manejo del estado en el lado de integración.
Si los identificadores y el entorno son correctos, pero el evento requerido aún no está presente, recopile la evidencia anterior y póngase en contacto con el soporte de DEUNA. No realice una operación de pago hasta que haya confirmado que es seguro repetirla.