> Mejora Continua de Procesos > Pagos en Procesamiento > Adyen > Plantilla de Datos

Su Plantilla de Datos de Procesamiento de Pagos

Adyen

Atributos de Procesamiento de Pagos (20) Actividades de Procesamiento de Pagos (16) Guías de Extracción (2)

Su Plantilla de Datos de Procesamiento de Pagos

Esta plantilla proporciona una guía completa para recopilar los datos necesarios para analizar el procesamiento de sus pagos en Adyen. Describe todos los atributos de datos esenciales y las actividades de proceso a rastrear, junto con instrucciones prácticas para la extracción de datos. Utilice esto para asegurarse de capturar toda la información crítica para un Process Mining eficaz.

Atributos recomendados para recopilar
Actividades clave para el seguimiento
Guía práctica de extracción para Adyen

¿Nuevo en registros de eventos? Aprenda cómo crear un registro de eventos para Process Mining.

Descargar Plantilla

Atributos de Procesamiento de Pagos

Estos son los campos de datos recomendados para incluir en su registro de eventos para un análisis exhaustivo de su procesamiento de pagos dentro de Adyen.

5 Requerido 7 Recomendado 8 Opcional

	Nombre	Descripción
	ID de Transacción de Pago PspReference	El identificador de referencia único asignado por Adyen a cada transacción de pago.
Descripción Este atributo sirve como clave principal para todo el ciclo de vida de los pagos dentro del ecosistema de Adyen. Vincula la solicitud de pago inicial a eventos subsiguientes como autorización, captura, liquidación y posibles reembolsos o retrocesiones. En el análisis, este ID se utiliza para agrupar eventos discretos en un único case, permitiendo la reconstrucción del proceso de principio a fin. Permite a los analistas rastrear el recorrido específico de un pago desde la iniciación del comprador hasta la liquidación financiera final. Por qué es importante Es el enlace fundamental que agrupa eventos desconectados en una única instancia de proceso para el Process Mining. Dónde obtener Respuesta de Pago de Adyen 'pspReference' o columna 'PSP Reference' del Informe Detallado de Liquidación. Ejemplos 851564567890123479145612345678908825641234567890
	Nombre de la Actividad EventCode	La etapa o acción específica que ocurre en el ciclo de vida del pago.
Descripción Este atributo define el evento específico que ha ocurrido, como AUTHORISATION, CAPTURE o REFUND. Dicta los nodos en el mapa de proceso y determina el flujo de la transacción. En el análisis, estos códigos se traducen en nombres de actividad legibles para visualizar el flujo del proceso. Las variaciones en la secuencia de estos códigos indican diferentes rutas de proceso, como el procesamiento directo versus el manejo de excepciones. Por qué es importante Define el 'qué' del modelo de Process Mining, permitiendo la visualización de los flujos de proceso. Dónde obtener Campo 'eventCode' de los Webhooks de Notificación de Adyen. Ejemplos AUTHORISATIONCAPTUREREEMBOLSOCANCELLATIONCHARGEBACK
	Timestamp del Evento EventDate	La fecha y hora en que ocurrió la actividad de pago específica.
Descripción Este atributo registra el timestamp preciso de cuándo se registró un evento (como autorización o liquidación) en el sistema. Permite el ordenamiento cronológico de actividades dentro de un case. En el análisis, esto es crucial para calcular los tiempos de ciclo, identificar cuellos de botella y determinar el rendimiento del sistema a lo largo del tiempo. Admite todos los KPI basados en el tiempo, como el 'Tiempo Total del Ciclo de Pago'. Por qué es importante Esencial para ordenar eventos y calcular todas las métricas basadas en duración. Dónde obtener Campo 'eventDate' de los Webhooks de Notificación de Adyen. Ejemplos 2023-10-27T10:00:00+01:002023-10-27T10:05:30+01:002023-10-28T09:15:00+01:00
	Source System SourceSystem	El nombre del sistema donde se originaron los datos.
Descripción Este atributo estático identifica que el registro provino de Adyen. En el Process Mining multisistema (por ejemplo, combinando Adyen con SAP), esto es crucial para la trazabilidad. En el análisis, permite a los usuarios filtrar actividades que ocurrieron específicamente dentro de la pasarela de pago versus el ERP o el sistema de gestión de pedidos. Por qué es importante Crucial para la trazabilidad de los datos en Process Mining multisistema. Dónde obtener Valor estático durante la extracción. Ejemplos AdyenAdyen_Production
	Última actualización de datos LastDataUpdate	La timestamp en que el registro fue extraído o actualizado por última vez.
Descripción Este atributo indica la actualidad de los datos en el modelo de Process Mining. Ayuda a los usuarios a comprender si están viendo datos en tiempo real o una instantánea. En el análisis, este es principalmente un campo técnico utilizado para la gobernanza de datos y para validar que el pipeline se está ejecutando correctamente. Por qué es importante Campo técnico para rastrear la actualidad de los datos. Dónde obtener Hora del sistema en la extracción. Ejemplos 2023-10-30T12:00:00Z
	¿Es Retrabajo? IsRework	Indicador que muestra si la transacción involucró reintentos o correcciones de errores.
Descripción Un indicador booleano que es verdadero si el caso contiene múltiples intentos de autorización, o si contiene actividades como 'Pago Rechazado' seguidas de un reintento. En el análisis, esto impulsa el dashboard de 'Puntos Críticos de Retrabajo y Excepciones de Pago'. Permite a los analistas filtrar específicamente los casos problemáticos para comprender por qué los flujos de proceso no siguen la ruta óptima. Por qué es importante Identifica casos ineficientes que requieren intervención manual o del sistema. Dónde obtener Calculado según la ocurrencia de eventos de fallo > 0. Ejemplos truefalse
	Cuenta de Comerciante MerchantAccount	La cuenta de comerciante específica dentro de Adyen que procesa la transacción.
Descripción Adyen permite múltiples cuentas de comerciante bajo una única cuenta de empresa. Este atributo identifica qué unidad de negocio, marca o entidad regional específica procesó el pago. En el análisis, esto sirve como una dimensión principal para la segmentación. Permite a las partes interesadas comparar el rendimiento, las tasas de fallo y los volúmenes en diferentes unidades de negocio o marcas para identificar áreas específicas de mejora. Por qué es importante Clave para segmentar el rendimiento por unidad de negocio o subsidiaria. Dónde obtener Solicitud/Respuesta de Pago de Adyen 'merchantAccount'. Ejemplos MyStore_UKMyStore_USGlobalSales_Main
	Estado de Pago PaymentStatus	El estado actual del pago (por ejemplo, Autorizado, Liquidado, Rechazado).
Descripción Este atributo refleja el último estado conocido de la transacción de pago. A menudo se deriva de la actividad más reciente en el case. En el análisis, permite un filtrado rápido de casos (por ejemplo, 'Mostrar todos los pagos actualmente Rechazados'). Es esencial para el dashboard 'Payment Throughput and Status Monitoring'. Por qué es importante Proporciona una instantánea del estado actual de la transacción. Dónde obtener Derivado del último código de evento en el caso. Ejemplos LiquidadaRechazadoAutorizado
	Importe de la Transacción PaymentAmount	El valor monetario de la transacción de pago.
Descripción Este atributo representa el valor financiero asociado con la transacción. Generalmente se almacena como una unidad menor (por ejemplo, centavos) en los datos brutos, pero debe convertirse para los informes. En el análisis, esto habilita el dashboard 'Payment Throughput' y ayuda a priorizar los casos de reelaboración de alto valor. También se utiliza para calcular el volumen total procesado y el impacto financiero de las transacciones fallidas. Por qué es importante Necesario para el análisis de impacto financiero y el monitoreo del rendimiento. Dónde obtener Solicitud de Pago de Adyen 'amount.value'. Ejemplos 10005509900
	Método de Pago PaymentMethod	El método específico utilizado por el comprador para pagar, como Visa o PayPal.
Descripción Este atributo captura el tipo de instrumento de pago utilizado, incluyendo marcas de tarjetas de crédito (Visa, MC), billeteras digitales (PayPal, Apple Pay) o métodos de pago locales (iDEAL, Sofort). En el análisis, esto es vital para el dashboard 'Payment Method Performance Insights'. Ayuda a establecer correlaciones entre métodos de pago específicos y tasas de autorización, velocidades de procesamiento o fallos técnicos. Por qué es importante Crítico para analizar las tasas de éxito y los costos en diferentes proveedores de pago. Dónde obtener Respuesta de Pago de Adyen 'paymentMethod.brand' o 'paymentMethod.type'. Ejemplos visamcpaypalidealklarna
	Motivo de Rechazo RefusalReason	La descripción de texto que explica por qué un pago fue rechazado o falló.
Descripción Cuando una transacción falla, Adyen proporciona un código o descripción del motivo (por ejemplo, 'Saldo insuficiente', 'CVC Denegado', 'Tarjeta Caducada'). En el análisis, este es el principal impulsor para el dashboard 'Payment Transaction Failure Rate'. Analizar estas razones ayuda a identificar si las fallas se deben a problemas técnicos, reglas de fraude o comportamiento del comprador, guiando acciones de remediación específicas. Por qué es importante El atributo clave para el análisis de la causa raíz de los pagos fallidos. Dónde obtener Respuesta de Pago de Adyen 'refusalReason'. Ejemplos RechazadoSaldo insuficienteTarjeta CaducadaError del AdquirenteFraude
	Tiempo Total del Ciclo de Pago TotalCycleTime	La duración total desde la creación de la solicitud de pago hasta la liquidación.
Descripción Esta es una métrica calculada que mide el tiempo transcurrido entre el primer evento (por ejemplo, 'Solicitud de Pago Recibida') y el evento 'Pago Liquidado'. En el análisis, este es el KPI de eficiencia principal. Destaca la velocidad del flujo de caja. Los tiempos de ciclo largos pueden indicar problemas con los retrasos en la captura o los ciclos de liquidación. Por qué es importante KPI para la optimización del capital de trabajo. Dónde obtener Calculado: Timestamp(Settled) - Timestamp(Created). Ejemplos 2 días4 horas5 minutos
	Código de Autorización AuthorisationCode	El código de autorización devuelto por el emisor tras la aprobación.
Descripción Un código que indica que los fondos han sido reservados en la tarjeta del comprador. Esta es la prueba de una autorización exitosa. En el análisis, esto es principalmente para auditoría y trazabilidad. Valida que la actividad 'Pago Autorizado' fue legítima. Por qué es importante Comprobante de autorización exitosa para pistas de auditoría. Dónde obtener Respuesta de Pago de Adyen 'authCode'. Ejemplos 123456098712
	ID de cliente ShopperReference	Una referencia única utilizada para identificar al comprador en múltiples transacciones.
Descripción Este identificador vincula diferentes transacciones a la misma entidad de cliente. Es proporcionado por el comerciante durante la solicitud de pago. En el análisis, esto permite un análisis centrado en el cliente, posibilitando la detección de reincidentes en casos de fraude o de clientes leales en el análisis de transacciones exitosas. Facilita el mapeo genérico del 'Cliente'. Por qué es importante Permite la agregación a nivel de cliente y el análisis de comportamiento. Dónde obtener Solicitud de Pago de Adyen 'shopperReference'. Ejemplos CUST-001user_12345email@example.com
	Moneda PaymentCurrency	El código ISO de tres letras que denota la moneda de la transacción.
Descripción Este atributo define la moneda en la que se expresa el `PaymentAmount`. Los valores comunes incluyen EUR, USD, GBP, etc. En el análisis, esto se utiliza para agrupar transacciones por mercado y es esencial para normalizar los valores financieros al agregar datos en diferentes regiones. Por qué es importante Contextualiza el campo de importe para informes multidivisa. Dónde obtener Solicitud de Pago de Adyen 'amount.currency'. Ejemplos EURUSDGBP
	Número de Lote de Liquidación BatchNumber	El número de lote asociado con la liquidación de fondos.
Descripción Adyen agrupa los pagos liquidados en lotes para su desembolso. Este atributo identifica a qué lote pertenece una transacción específica. En el análisis, esto se utiliza para agrupar los pagos por su ciclo de desembolso. Ayuda en la auditoría si hay lotes específicos retrasados y apoya el seguimiento de la actividad 'Pago Liquidado'. Por qué es importante Vincula transacciones individuales a liquidaciones financieras masivas. Dónde obtener Informe Detallado de Liquidación de Adyen 'Batch Number'. Ejemplos 100255
	País del Comprador ShopperCountry	El código de país de dos letras del comprador.
Descripción Este atributo indica la ubicación del comprador, típicamente derivada del país emisor de la tarjeta o la dirección de facturación. En el análisis, se utiliza para el análisis de rendimiento regional. Ayuda a identificar si países específicos tienen tasas de denegación más altas o tiempos de procesamiento más lentos debido a la infraestructura bancaria local. Por qué es importante Permite la segmentación geográfica del rendimiento de los pagos. Dónde obtener Solicitud de Pago de Adyen 'countryCode' o 'billingAddress.country'. Ejemplos NLUSDE
	Puntuación de Riesgo de Fraude RiskScore	La puntuación de riesgo asignada a la transacción por el motor de fraude.
Descripción El motor RevenueProtect de Adyen asigna una puntuación numérica (0-100) que indica la probabilidad de fraude. Las puntuaciones más altas a menudo activan una revisión manual o un bloqueo automático. En el análisis, esto apoya la 'Visión General del Riesgo de Cumplimiento Financiero'. Correlacionar puntuaciones de alto riesgo con contracargos ayuda a ajustar las reglas de fraude. Las puntuaciones altas que resultan en pagos exitosos podrían indicar falsos positivos en el modelo de riesgo. Por qué es importante Esencial para analizar la eficiencia de la lógica de prevención de fraude. Dónde obtener Respuesta de la API de Riesgos de Adyen o Informes 'fraudResult.accountScore'. Ejemplos 025100
	Referencia del Adquirente AcquirerReference	Número de referencia proporcionado por el banco adquirente.
Descripción Esta es la referencia externa asignada por la institución financiera subyacente (adquirente) que procesa la transacción con tarjeta. Es distinta de la referencia PSP de Adyen. En el análisis, este campo es crítico para el 'Análisis de Retraso en la Conciliación de Pagos'. Es la clave utilizada para comparar los registros de Adyen con los extractos bancarios en libros de contabilidad externos. Por qué es importante Esencial para la conciliación a tres vías y la conciliación externa. Dónde obtener Respuesta de Pago de Adyen 'additionalData.acquirerReference'. Ejemplos 1234567890987654321
	Tipo de Interacción del Comprador ShopperInteraction	Indica si el pago fue de Comercio Electrónico, POS o una suscripción (ContAuth).
Descripción Este atributo categoriza la naturaleza de la interacción entre el comprador y el comerciante. Los valores típicos son `Ecommerce` (online), `POS` (en tienda) o `ContAuth` (recurrente/suscripción). En el análisis, esto ayuda a distinguir entre diferentes modelos de negocio y canales de venta. Los flujos de proceso a menudo difieren significativamente entre POS y Ecommerce, lo que lo convierte en un filtro vital para un descubrimiento de proceso limpio. Por qué es importante Diferencia los flujos de proceso entre pagos en línea, en tienda y recurrentes. Dónde obtener Solicitud de Pago de Adyen 'shopperInteraction'. Ejemplos Comercio ElectrónicoContAuthPOSMoto

Requerido Recomendado Opcional

Actividades de Procesamiento de Pagos

Estos son los pasos y hitos clave del proceso a capturar en su registro de eventos para un descubrimiento de proceso preciso en sus flujos de pagos de Adyen.

5 Recomendado 11 Opcional

	Actividad	Descripción
	Pago Autorizado	El emisor de la tarjeta o el método de pago ha aprobado la transacción y los fondos están reservados. Capturado a través del webhook de notificación estándar de Adyen.
Por qué es importante Un hito crítico que indica que la transacción es válida y los fondos están disponibles. Condición previa para la captura. Dónde obtener Adyen Notification Webhook: eventCode 'AUTHORISATION' con success='true'. Capturar Registrado en éxito del webhook de AUTORIZACIÓN Tipo de evento explicit
	Pago Capturado	La orden de transferir fondos del comprador al comerciante ha sido procesada con éxito. Esto puede ser inmediato (captura automática) o demorado (captura manual).
Por qué es importante Confirma el reconocimiento de ingresos. El tiempo entre la Autorización y la Captura es clave para el KPI 'Tiempo de Espera de Autorización de Pago'. Dónde obtener Adyen Notification Webhook: eventCode 'CAPTURE' con success='true'. Capturar Registrado en éxito del webhook de CAPTURA Tipo de evento explicit
	Pago Liquidado	Los fondos han sido compensados y acreditados con éxito en la cuenta de Adyen del comerciante. Esto aparece en el Informe Detallado de Liquidación.
Por qué es importante La conclusión financiera del proceso exitoso. Esencial para el 'Tiempo Total del Ciclo de Pago' y el 'Análisis de Retraso en la Conciliación de Pagos'. Dónde obtener Informe Detallado de Liquidación de Adyen (SDR), tipo de registro 'Liquidado'. Capturar Registrado cuando la transacción aparece en el Informe de Liquidación Tipo de evento explicit
	Pago Rechazado	La transacción fue denegada por el emisor o las reglas de riesgo de Adyen. Capturada a través del webhook de autorización con un estado de fallo.
Por qué es importante Impacta directamente el KPI de 'Tasa de Fallo de Transacciones de Pago'. El análisis de las razones de rechazo ayuda a optimizar las tasas de autorización. Dónde obtener Adyen Notification Webhook: eventCode 'AUTHORISATION' con success='false'. Capturar Registrado en fallo del webhook de AUTORIZACIÓN Tipo de evento explicit
	Solicitud de Pago Recibida	La recepción inicial de la solicitud de transacción por parte de la plataforma de pagos de Adyen. Esto se captura a partir del timestamp de la solicitud inicial de la API o la creación del pspReference.
Por qué es importante Marca el inicio absoluto de la instancia del proceso. Esencial para calcular el tiempo total del ciclo de principio a fin. Dónde obtener Registros de la API de Pagos de Adyen o la marca de tiempo asociada con la creación del pspReference. Capturar Registrado cuando pspReference se genera a través de la API Tipo de evento explicit
	Captura Fallida	El intento de capturar fondos autorizados falló, a menudo debido a un tiempo de espera técnico o cambios en el estado de la tarjeta entre la autorización y la captura.
Por qué es importante Punto de error crítico que requiere retrabajo o reintento. Contribuye a la 'Tasa de Excepciones de Pago'. Dónde obtener Adyen Notification Webhook: eventCode 'CAPTURE_FAILED'. Capturar Registrado en webhook de CAPTURE_FAILED Tipo de evento explicit
	Contracargo Defendido	Se ha presentado evidencia a Adyen para impugnar un contracargo. Esto representa una actividad de retrabajo/manual en el flujo de disputa.
Por qué es importante Registra el esfuerzo dedicado a la protección de ingresos. Importante para la 'Tasa de Reelaboración de Pagos'. Dónde obtener API de Disputas de Adyen o registros de Gestión de Casos que muestran el envío de pruebas. Capturar Inferido del cambio de estado a 'Defensa Suministrada' Tipo de evento inferred
	Contracargo Revertido	La disputa se ganó y los fondos se devuelven al comerciante. Esta es una resolución exitosa de una excepción.
Por qué es importante Resultado positivo para la gestión de riesgos. Compensa el impacto financiero de la retrocesión inicial. Dónde obtener Adyen Notification Webhook: eventCode 'CHARGEBACK_REVERSED'. Capturar Registrado en webhook de CONTRACARGO_REVERTIDO Tipo de evento explicit
	Error Técnico Registrado	Se produjo un error del sistema durante el procesamiento, como un fallo del webhook o un tiempo de espera de la API. Identificado mediante códigos de error específicos en la interfaz.
Por qué es importante Apoya directamente el análisis de la 'Tasa de Fallo de Transacciones de Pago' al categorizar los fallos técnicos frente a los financieros. Dónde obtener Registros de la Interfaz de Adyen o respuestas de fallo específicas en llamadas a la API. Capturar Registrado cuando se devuelve el código de respuesta de error 5xx o 4xx Tipo de evento explicit
	Evaluación de Riesgos Realizada	El motor RevenueProtect de Adyen analiza la transacción en busca de señales de fraude. Esto se infiere de la presencia de una puntuación de fraude o un resultado de riesgo en la respuesta de autorización.
Por qué es importante Las puntuaciones de alto riesgo pueden activar revisiones manuales o rechazos automáticos, creando cuellos de botella o puntos de terminación del proceso. Dónde obtener Respuesta de Pago de Adyen (campo fraudResult) o registros de Gestión de Casos. Capturar Inferido de la presencia del objeto fraudResult Tipo de evento inferred
	Notificación de Contracargo Recibida	Adyen ha recibido una notificación de disputa del esquema de tarjetas. Esto activa el flujo de trabajo de disputa.
Por qué es importante Indicador principal de cumplimiento y riesgo. Impulsa la 'Tasa de Incidentes de Cumplimiento' y requiere intervención manual inmediata. Dónde obtener Adyen Notification Webhook: eventCode 'CHARGEBACK' o 'NOTIFICATION_OF_CHARGEBACK'. Capturar Registrado en webhook de CONTRACARGO Tipo de evento explicit
	Pago Cancelado	La autorización fue anulada antes de que se capturaran los fondos. Esto libera los fondos reservados en la tarjeta del comprador.
Por qué es importante Representa un bucle de proceso donde un pedido válido se termina antes de su finalización, a menudo debido a la solicitud del cliente o a un tiempo de espera del inventario. Dónde obtener Adyen Notification Webhook: eventCode 'CANCELLATION'. Capturar Registrado en webhook de CANCELACIÓN Tipo de evento explicit
	Pago Confirmado	Los fondos asociados a un lote de transacciones liquidadas han sido desembolsados a la cuenta bancaria del comerciante.
Por qué es importante Representa la transferencia de efectivo real a la empresa, vinculado al 'Tiempo del Ciclo de Conciliación de Pagos'. Dónde obtener Adyen Notification Webhook: eventCode 'PAYOUT_THIRD_PARTY' o inferido del Informe de Pagos. Capturar Unir el ID de lote del Informe de Pagos al ID de Transacción Tipo de evento inferred
	Pago Enviado para Liquidación	Adyen ha reenviado la transacción al banco adquirente o a la red para su procesamiento financiero. El estado cambia a SentForSettlement.
Por qué es importante Marca la transición del procesamiento operacional a la compensación financiera. Los retrasos aquí afectan el flujo de caja. Dónde obtener API de Estado de Transacciones de Adyen o inferido de los registros de historial de cambio de estado. Capturar Comparar la transición del campo de estado a SentForSettlement Tipo de evento inferred
	Reembolso Iniciado	Se ha activado una solicitud para devolver fondos al comprador. Esto inicia un flujo de proceso inverso.
Por qué es importante Indica una excepción posterior a la liquidación. Las altas tasas de reembolso pueden indicar problemas de calidad aguas arriba. Dónde obtener Adyen Notification Webhook: eventCode 'REFUND'. Capturar Registrado en activación del webhook de REEMBOLSO Tipo de evento explicit
	Reembolso Liquidado	El reembolso ha sido procesado financieramente y debitado de la cuenta del comerciante. Confirmado a través del Informe de Detalles de Liquidación.
Por qué es importante Cierra el ciclo del proceso de reembolso. Importante para el 'Tiempo Promedio de Resolución de Errores' si el reembolso se debió a un error. Dónde obtener Informe Detallado de Liquidación de Adyen, tipo de registro 'Reembolsado' o 'ReembolsoRevertido'. Capturar Registrado cuando el reembolso aparece en el Informe de Liquidación Tipo de evento explicit

Recomendado Opcional

Guías de Extracción

Cómo obtener sus datos de Adyen

Pasos

Inicie sesión en el Área de Cliente de Adyen con una cuenta de usuario que tenga el rol de Informe de Comerciante.
Vaya a Informes y seleccione Detalles de liquidación del menú.
Localice la configuración de Generación automática o elija Generar informe para una exportación única.
En el panel de configuración, asegúrese de que el Formato esté establecido en CSV (valores separados por comas).
En Incluir columnas, asegúrese de seleccionar Todas o verifique específicamente: Company Account, Merchant Account, Psp Reference, Merchant Reference, Payment Method, Creation Date, TimeZone, Type, Modification Reference, Gross Currency, Gross Debit, Gross Credit, Exchange Rate, Net Currency, Net Debit, Net Credit, Commission, Markup, Scheme Fees y Interchange.
IMPORTANTE: Asegúrese de que el alcance del informe incluya todos los Tipos de Asiento (Settled, Refunded, Chargeback, PaidOut, etc.) para capturar el ciclo de vida financiero completo.
Genere el informe para el rango de fechas deseado (por ejemplo, Últimos 90 Días). Tenga en cuenta que los informes de liquidación se generan basándose en la fecha del lote de liquidación, no en la fecha de la transacción.
Descargue el archivo CSV generado a su entorno de extracción local.
Ejecute el script de transformación (proporcionado a continuación) para remodelar el libro mayor CSV 'Ancho' en un formato de Registro de Eventos 'Largo' requerido por ProcessMind.
El script realiza transformaciones críticas: despivota la Creation Date para crear eventos de 'Solicitud de Pago Recibida' y mapea la columna Type a actividades financieras específicas.
Verifique que el CSV de salida contenga los encabezados: PspReference, EventCode, EventDate, SourceSystem.
Suba el CSV transformado final a ProcessMind.

Configuración

Tipo de Informe: Informe Detallado de Liquidación (libro mayor financiero)
Formato de Archivo: CSV (separación estándar por comas)
Granularidad: Nivel de Transacción (una fila por entrada de asiento financiero)
Zona Horaria: UTC (fuertemente recomendado para alinear la extracción con otros sistemas)
Rango de Fechas: Se alinea con los Lotes de Liquidación (Fecha de Cierre de Lote), no con la Fecha de Creación de la Transacción. Asegúrese de manejar la superposición si se ejecuta de forma incremental.
Columnas Requeridas: Psp Reference (Clave), Type (Actividad), Creation Date, Booking Date (Marcas de Tiempo de Evento), Merchant Account.
Configuración de Filtros: Asegúrese de que ningún filtro excluya los tipos 'Chargeback' o 'Refund' para garantizar la integridad del proceso.

a Consulta de ejemplo config

import pandas as pd
from datetime import datetime

# CONFIGURATION
INPUT_FILE = 'settlement_detail_report.csv'
OUTPUT_FILE = 'adyen_event_log.csv'
SOURCE_SYSTEM = 'Adyen'

# Load the Adyen Settlement Detail Report
# Skip standard Adyen header rows if present (often reports start on row 1 or have metadata on top)
df = pd.read_csv(INPUT_FILE, keep_default_na=False)

# Define the output list
event_log = []

# Helper function to append events
def add_event(psp_ref, activity, timestamp, attributes):
    if not timestamp or str(timestamp).strip() == '':
        return
    base_event = {
        'PspReference': psp_ref,
        'EventCode': activity,
        'EventDate': timestamp,
        'SourceSystem': SOURCE_SYSTEM,
        'LastDataUpdate': datetime.utcnow().isoformat(),
        'MerchantAccount': attributes.get('Merchant Account', ''),
        'PaymentMethod': attributes.get('Payment Method', ''),
        'PaymentAmount': attributes.get('Gross Credit', 0) if attributes.get('Gross Credit') else attributes.get('Gross Debit', 0) * -1
    }
    # Merge optional attributes
    base_event.update(attributes)
    event_log.append(base_event)

# Iterate through the ledger rows
for index, row in df.iterrows():
    psp_ref = row.get('Psp Reference')
    journal_type = row.get('Type')
    creation_date = row.get('Creation Date') # Used for Auth/Request
    booking_date = row.get('Booking Date')   # Used for Settlement/Financials
    
    # Common attributes for this row
    row_attrs = {
        'MerchantAccount': row.get('Merchant Account'),
        'PaymentMethod': row.get('Payment Method'),
        'RefusalReason': row.get('Refusal Reason', ''),
        'PaymentStatus': journal_type
    }

    # --- 1. DERIVED UPSTREAM ACTIVITIES ---
    # Since this is a settlement report, we infer the Request/Auth from the Creation Date
    # of the first record we see for this PSP Reference. 
    # Logic: If Creation Date exists, implies Request and Auth occurred.
    
    if creation_date:
        # Activity: Payment Request Received
        add_event(psp_ref, 'Payment Request Received', creation_date, row_attrs)
        
        # Activity: Risk Screening Performed (Inferred from existence of transaction)
        # Note: True risk score requires 'Payments Accounting Report', inferred here for process continuity
        add_event(psp_ref, 'Risk Screening Performed', creation_date, row_attrs)
        
        # Activity: Payment Authorised
        # Typically happens immediately after request for successful settled items
        add_event(psp_ref, 'Payment Authorised', creation_date, row_attrs)

    # --- 2. MAPPED FINANCIAL ACTIVITIES ---
    # Map Adyen Ledger Types to Process Activities using Booking Date
    
    if journal_type == 'Settled':
        add_event(psp_ref, 'Payment Settled', booking_date, row_attrs)
        
        # Activity: Payment Sent for Settlement
        # Inferred: Occurs shortly before settlement. 
        # Using Creation Date if Booking Date is distinct, or defaulting to Booking Date.
        sent_date = creation_date if creation_date else booking_date
        add_event(psp_ref, 'Payment Sent for Settlement', sent_date, row_attrs)

    elif journal_type == 'Refunded':
        add_event(psp_ref, 'Refund Initiated', creation_date, row_attrs)
        add_event(psp_ref, 'Refund Settled', booking_date, row_attrs)

    elif journal_type == 'Chargeback':
        add_event(psp_ref, 'Chargeback Notification Received', booking_date, row_attrs)

    elif journal_type == 'ChargebackRetried':
        add_event(psp_ref, 'Chargeback Defended', booking_date, {'IsRework': 'True'})

    elif journal_type == 'ChargebackReversed':
        add_event(psp_ref, 'Chargeback Reversed', booking_date, row_attrs)

    elif journal_type == 'PaidOut':
        # Payouts often group many transactions. 
        # If the report is at transaction level, this row represents the batch payout.
        add_event(psp_ref, 'Payout Confirmed', booking_date, row_attrs)

    elif journal_type == 'CaptureFailed':
        add_event(psp_ref, 'Capture Failed', booking_date, {'IsRework': 'True'})

    # --- 3. EXCEPTION HANDLING ---
    # These statuses often appear in 'Received payment details' reports but rarely in Settlement
    # unless fees were applied.
    
    elif journal_type == 'Refused': 
        add_event(psp_ref, 'Payment Refused', creation_date, row_attrs)
        
    elif journal_type == 'Cancelled':
        add_event(psp_ref, 'Payment Cancelled', creation_date, row_attrs)

    elif journal_type == 'Error':
        add_event(psp_ref, 'Technical Error Logged', booking_date, {'IsRework': 'True'})

# Convert to DataFrame
events_df = pd.DataFrame(event_log)

# Deduping: Adyen reports may have multiple lines for partial settlements.
# We sort by date and keep unique Activity per PSP Reference if timestamps match exactly.
events_df.drop_duplicates(subset=['PspReference', 'EventCode', 'EventDate'], inplace=True)

# Output
events_df.to_csv(OUTPUT_FILE, index=False)
print(f'Successfully extracted {len(events_df)} events to {OUTPUT_FILE}')

Pasos

Configuración de Requisitos Previos: Asegúrese de tener un usuario de informes de Adyen con el rol de Informe de Comerciante habilitado. Obtenga su Clave API del Área de Cliente en Desarrolladores > Credenciales de API.
Identificar Informes Requeridos: Esta extracción se basa en dos informes CSV clave generados por Adyen: el Informe Detallado de Liquidación (para eventos financieros como Liquidación, Contracargos, Reembolsos) y el Informe Detallado de Pagos Recibidos (para eventos operativos como Solicitudes, Rechazos, Autorizaciones).
Configuración del Entorno Python: Instale las bibliotecas necesarias usando pip: pandas, requests y numpy. Estas se utilizarán para la comunicación de la API y la transformación de datos.
Implementación de la Conexión API: Configure el script Python (proporcionado a continuación) para autenticarse contra los puntos finales https://management-test.adyen.com o https://management-live.adyen.com. Utilizará la API de Informes para listar los informes disponibles para su rango de fechas específico y descargar las URLs.
Ingesta de Datos: El script lee los datos CSV sin procesar en DataFrames de pandas. Los informes de Adyen suelen ser 'anchos' (una fila por transacción con múltiples columnas de estado), por lo que se requiere transformación.
Mapeo de Actividades - Operacional: Procese el Informe Detallado de Pagos Recibidos. Mapee la CreationDate a Solicitud de Pago Recibida. Utilice lógica para inspeccionar la columna Status (por ejemplo, Autorizado, Rechazado, Error) para generar eventos de Pago Autorizado, Pago Rechazado o Error Técnico Registrado.
Mapeo de Actividades - Financiero: Procese el Informe Detallado de Liquidación. Este informe contiene una columna JournalType. Mapee valores como Settled a Pago Liquidado, Refunded a Reembolso Iniciado y Chargeback a Notificación de Contracargo Recibida.
Inferencia de Actividades Complejas:
- Evaluación de Riesgos Realizada: Verifique si la columna FraudScore está poblada y es mayor que -1.
- Pago Confirmado: Vincule las transacciones a través del BatchNumber a la entrada de Pago en el informe de liquidación.
- Contracargo Defendido: Busque los tipos de asiento SecondChargeback o Defense.
Transformación de Datos: Aplique una operación de 'melt' o 'stack' en pandas para convertir el conjunto de datos ancho en un formato de registro de eventos largo donde cada actividad es una fila separada.
Estandarización de Atributos: Cambie el nombre de las columnas para que coincidan con el esquema objetivo: PspReference, EventCode, EventDate, SourceSystem (codificado a 'Adyen') y PaymentAmount. Asegúrese de que las fechas se analicen en formato ISO 8601.
Filtrado: Filtre las filas de conciliación internas que no representan pasos del proceso (por ejemplo, filas de encabezado o arrastres de saldo) utilizando el filtro Type.
Exportación Final: El script exporta el DataFrame procesado a un archivo CSV llamado adyen_event_log.csv, listo para subir a ProcessMind.

Configuración

Entorno de la API: Cambie entre los puntos finales de Adyen Test (management-test.adyen.com) y Live (management-live.adyen.com) según la fase de implementación.
Autenticación: Use x-api-key en el encabezado. No utilice Basic Auth para la API de Gestión.
Tipos de Informe:
- settlement_detail_report: Crítico para eventos del ciclo de vida financiero.
- received_payment_detail_report: Crítico para la solicitud inicial y la lógica de autorización.
Rango de Fechas: Los informes de Adyen se generan en función del cierre del lote. Asegúrese de que el script solicite informes que cubran la CreationDate de interés + 7 días para capturar liquidaciones retrasadas.
Alcance de la Cuenta de Comerciante: Si tiene varias cuentas de comerciante, itere a través de la lista de cuentas o utilice el informe a nivel de Cuenta de Empresa si está disponible.
Configuración de Pandas: Asegúrese de que low_memory=False esté configurado al leer CSV si el volumen de transacciones supera las 100.000 filas para evitar errores de inferencia de tipo.

a Consulta de ejemplo python

import pandas as pd
import requests
import io
import numpy as np
from datetime import datetime

class=class="hl-string">"hl-comment"># Configuration
API_KEY = class="hl-string">'YOUR_ADYEN_API_KEY'
MERCHANT_ACCOUNT = class="hl-string">'YOUR_MERCHANT_ACCOUNT'
BASE_URL = class="hl-string">'https://management-live.adyen.com/v1'
HEADERS = {class="hl-string">'x-api-key': API_KEY, class="hl-string">'Content-Type': class="hl-string">'application/json'}

class=class="hl-string">"hl-comment"># Placeholder for fetching report URLs via API
class=class="hl-string">"hl-comment"># In production, use GET /companies/{companyId}/reports or /merchants/{merchantId}/reports
class=class="hl-string">"hl-comment"># For this script, we assume the CSV content is loaded into DataFrames

def transform_adyen_data(received_payments_csv_path, settlement_details_csv_path):
    
    class=class="hl-string">"hl-comment"># 1. Load Data
    print(class="hl-string">'Loading reports...')
    df_received = pd.read_csv(received_payments_csv_path)
    df_settled = pd.read_csv(settlement_details_csv_path)

    events = []

    class=class="hl-string">"hl-comment"># 2. Process Received Payment Detail Report (Operational Events)
    class=class="hl-string">"hl-comment"># This report covers: Request, Auth, Refusal, Risk, Capture, Errors
    
    for _, row in df_received.iterrows():
        psp = str(row.get(class="hl-string">'PspReference', class="hl-string">''))
        created_date = pd.to_datetime(row.get(class="hl-string">'CreationDate'))
        amount = row.get(class="hl-string">'Amount', 0)
        status = row.get(class="hl-string">'Status', class="hl-string">'')
        fraud_score = row.get(class="hl-string">'FraudScore', None)
        refusal_reason = row.get(class="hl-string">'RefusalReason', class="hl-string">'')
        
        class=class="hl-string">"hl-comment"># Activity: Payment Request Received
        events.append({
            class="hl-string">'PspReference': psp,
            class="hl-string">'EventCode': class="hl-string">'Payment Request Received',
            class="hl-string">'EventDate': created_date,
            class="hl-string">'PaymentAmount': amount,
            class="hl-string">'PaymentMethod': row.get(class="hl-string">'PaymentMethod', class="hl-string">''),
            class="hl-string">'RefusalReason': None,
            class="hl-string">'SourceSystem': class="hl-string">'Adyen'
        })

        class=class="hl-string">"hl-comment"># Activity: Risk Screening Performed
        class=class="hl-string">"hl-comment"># Inferred if a fraud score was calculated
        if pd.notna(fraud_score):
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Risk Screening Performed',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=1), class=class="hl-string">"hl-comment"># Slight offset
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })

        class=class="hl-string">"hl-comment"># Activity: Payment Authorised / Refused / Error
        if status == class="hl-string">'Authorised':
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Payment Authorised',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=2),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })
        elif status == class="hl-string">'Refused':
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Payment Refused',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=2),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'RefusalReason': refusal_reason,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })
        elif status == class="hl-string">'Error':
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Technical Error Logged',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=2),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'RefusalReason': row.get(class="hl-string">'AcquirerResponse', class="hl-string">'Technical Error'),
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })
        elif status == class="hl-string">'Cancelled':
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Payment Cancelled',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=5),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })

    class=class="hl-string">"hl-comment"># 3. Process Settlement Detail Report (Financial Events)
    class=class="hl-string">"hl-comment"># This report covers: Capture, Settlement, Refunds, Chargebacks, Payouts
    
    for _, row in df_settled.iterrows():
        psp = str(row.get(class="hl-string">'PspReference', class="hl-string">''))
        journal_type = row.get(class="hl-string">'JournalType', class="hl-string">'')
        process_date = pd.to_datetime(row.get(class="hl-string">'CreationDate')) class=class="hl-string">"hl-comment"># Or ProcessingDate
        amount = row.get(class="hl-string">'NetCredit', 0) if pd.notna(row.get(class="hl-string">'NetCredit')) else row.get(class="hl-string">'GrossCredit', 0)
        
        class=class="hl-string">"hl-comment"># Map JournalType to Activities
        activity_name = None
        
        if journal_type == class="hl-string">'SentForSettlement':
            activity_name = class="hl-string">'Payment Sent for Settlement'
        elif journal_type == class="hl-string">'Settled':
            activity_name = class="hl-string">'Payment Settled'
        elif journal_type == class="hl-string">'SentForRefund' or journal_type == class="hl-string">'Refunded':
            activity_name = class="hl-string">'Refund Initiated'
        elif journal_type == class="hl-string">'SettledRefund':
            activity_name = class="hl-string">'Refund Settled'
        elif journal_type == class="hl-string">'Chargeback':
            activity_name = class="hl-string">'Chargeback Notification Received'
        elif journal_type == class="hl-string">'SecondChargeback' or journal_type == class="hl-string">'Defense':
            activity_name = class="hl-string">'Chargeback Defended'
        elif journal_type == class="hl-string">'ChargebackReversed':
            activity_name = class="hl-string">'Chargeback Reversed'
        elif journal_type == class="hl-string">'CaptureFailed':
            activity_name = class="hl-string">'Capture Failed'
        elif journal_type == class="hl-string">'PaidOut':
            class=class="hl-string">"hl-comment"># PaidOut is usually batch level, if psp is present, map it
            activity_name = class="hl-string">'Payout Confirmed'
        
        class=class="hl-string">"hl-comment"># Logic for class="hl-string">'Payment Captured' 
        class=class="hl-string">"hl-comment"># Adyen often auto-captures. If we see Settled, we assume Captured occurred prior if not explicitly logged.
        class=class="hl-string">"hl-comment"># Here we rely on class="hl-string">'SentForSettlement' as the trigger for Capture success in many flows.
        if journal_type == class="hl-string">'SentForSettlement':
             events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Payment Captured',
                class="hl-string">'EventDate': process_date - pd.Timedelta(seconds=1),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })

        if activity_name:
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': activity_name,
                class="hl-string">'EventDate': process_date,
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen',
                class="hl-string">'MerchantAccount': row.get(class="hl-string">'MerchantAccount', MERCHANT_ACCOUNT),
                class="hl-string">'PaymentMethod': row.get(class="hl-string">'PaymentMethod', class="hl-string">'')
            })

    class=class="hl-string">"hl-comment"># 4. Create DataFrame
    df_events = pd.DataFrame(events)
    
    class=class="hl-string">"hl-comment"># 5. Post-Processing & Cleanup
    if not df_events.empty:
        class=class="hl-string">"hl-comment"># Ensure standard columns
        df_events[class="hl-string">'LastDataUpdate'] = datetime.now().isoformat()
        df_events[class="hl-string">'TotalCycleTime'] = None class=class="hl-string">"hl-comment"># Calculated in ProcessMind
        df_events[class="hl-string">'IsRework'] = df_events[class="hl-string">'EventCode'].apply(lambda x: 1 if class="hl-string">'Chargeback' in x or class="hl-string">'Refused' in x else 0)
        df_events[class="hl-string">'PaymentStatus'] = df_events.sort_values(class="hl-string">'EventDate').groupby(class="hl-string">'PspReference')[class="hl-string">'EventCode'].transform(class="hl-string">'last')
        
        class=class="hl-string">"hl-comment"># Filter invalid rows (empty PspReference)
        df_events = df_events[df_events[class="hl-string">'PspReference'] != class="hl-string">'nan']
        df_events = df_events[df_events[class="hl-string">'PspReference'] != class="hl-string">'']

        class=class="hl-string">"hl-comment"># Sort
        df_events = df_events.sort_values([class="hl-string">'PspReference', class="hl-string">'EventDate'])
        
    return df_events

class=class="hl-string">"hl-comment"># Execution Entry Point
class=class="hl-string">"hl-comment"># Replace paths with actual file locations or API download streams
if __name__ == class="hl-string">'__main__':
    class=class="hl-string">"hl-comment"># Example usage
    df_log = transform_adyen_data(class="hl-string">'received_payment_detail_report.csv', class="hl-string">'settlement_detail_report.csv')
    
    class=class="hl-string">"hl-comment"># Export
    df_log.to_csv(class="hl-string">'ProcessMind_Adyen_Log.csv', index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
    print(fclass="hl-string">'Extraction Complete. Generated {len(df_log)} events.')

Su Plantilla de Datos de Procesamiento de Pagos

Su Plantilla de Datos de Procesamiento de Pagos

Atributos de Procesamiento de Pagos

Actividades de Procesamiento de Pagos

Guías de Extracción

Exportación del Informe Detallado de Liquidación de Adyen

Pasos

Configuración

a Consulta de ejemplo config

Extracción Python vía API de Reporting

Pasos

Configuración

a Consulta de ejemplo python

¿Listo para comenzar?

Optimice el Procesamiento de Pagos en Adyen Hoy.

Su Plantilla de Datos de Procesamiento de Pagos

Su Plantilla de Datos de Procesamiento de Pagos

Atributos de Procesamiento de Pagos

Actividades de Procesamiento de Pagos

Guías de Extracción

Exportación del Informe Detallado de Liquidación de Adyen

Pasos

Configuración

a Consulta de ejemplo config

Extracción Python vía API de Reporting

Pasos

Configuración

a Consulta de ejemplo python

Valoramos su privacidad

¿Listo para comenzar?

Optimice el Procesamiento de Pagos en Adyen Hoy.