# 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.