Registrar solicitudes para Merchant y Autopayouts
Las secciones “Para Comerciantes” y “Para Autopagos” muestran registros de integración que indican cómo el sistema interactúa con servicios externos. Ambas páginas comparten la misma estructura y lógica, diferenciándose solo en el contexto: Registros del comerciante — para operaciones en el lado del comerciante (generación de billeteras, creación/procesamiento de transacciones, integraciones de pago). Registros de autopagos — para pagos automáticos ejecutados a través de proveedores integrados.
El propósito principal de estas secciones es proporcionar explicaciones detalladas de errores, reducir las consultas al soporte y garantizar un seguimiento transparente de las solicitudes de integración.
1. Cuando se crea un registro
Se genera un registro automáticamente cuando:
Una solicitud a un servicio externo devuelve un error.
Falla la generación de la billetera.
Un autopago no se ejecuta (error, tiempo de espera, datos inválidos, etc.).
Un proveedor devuelve una respuesta incorrecta o inesperada.
Un enlace al registro correspondiente aparece directamente dentro del pedido relacionado en el panel de administración, conectando el registro con la operación específica.
2. Descripción de las columnas
Ambas secciones contienen el mismo conjunto de campos:
ID de solicitud
Identificador externo del pedido asociado con el registro. Permite a los administradores entender rápidamente a qué solicitud se refiere el registro.
Estado
Estado actual de la solicitud de integración. Valores posibles:
success — el proveedor devolvió una respuesta exitosa
error — ocurrió un error
Proveedor
El nombre del servicio o módulo de pago utilizado para la solicitud (sistema de pago, proveedor de cripto, servicio de autopagos).
Respuesta
Datos de respuesta sin procesar devueltos por el servicio externo. Pueden incluir:
código de error
mensaje de error
payload técnico
estado HTTP
metadatos a nivel de API
Información
Muestra una explicación legible del error si está disponible.
Lógica:
Si el proveedor tiene documentación y el sistema puede interpretar el código de error, el campo muestra un mensaje legible (por ejemplo, “Saldo insuficiente”).
Si el proveedor no proporciona códigos estructurados, el campo muestra la respuesta en bruto en inglés.
Este campo es esencial para que los administradores o agentes de soporte comprendan el problema rápidamente.
Fecha de creación
La marca de tiempo cuando el error o evento fue registrado. Se muestra en el formato: DD.MM.AAAA, HH:MM:SS
3. Propósito y beneficios
Los registros permiten:
diagnosticar rápidamente problemas técnicos sin involucrar a los desarrolladores;
ver en detalle qué respondió el servicio externo;
identificar la causa de autopagos fallidos o de la generación de billeteras;
reducir solicitudes al soporte como “verificar por qué falló el pago”;
mantener un historial cronológico completo de errores de integración.
4. Uso en las operaciones diarias
Un administrador puede:
abrir el registro desde el pedido y ver de inmediato la causa del problema;
reenviar el pago/la solicitud si la lógica del sistema lo permite;
dar al cliente una explicación precisa basada en el error interpretado;
remitir el registro a los desarrolladores si el proveedor devolvió una respuesta no estándar.
Si quieres, puedo hacerlo en formato de documento Markdown o adaptarlo a vuestro estilo interno de documentación.
Última actualización