> Melhoria Contínua de Processos > Pagamentos em Processamento > Adyen > Modelo de Dados

Seu Template de Dados de Processamento de Pagamentos

Adyen

Atributos de Processamento de Pagamento (20) Atividades de Processamento de Pagamento (16) Guias de Extração (2)

Seu Template de Dados de Processamento de Pagamentos

Este template é um guia completo para coletar os dados necessários para analisar seus pagamentos na Adyen. Ele detalha atributos essenciais, atividades a monitorar e instruções de extração. Use-o para garantir que todas as informações críticas para o Process Mining sejam capturadas.

Atributos recomendados para coletar
Atividades-chave a monitorizar
Guia prático de extração para Adyen

É novo em event logs? Saiba como criar um event log para Process Mining.

Baixar Modelo

Atributos de Processamento de Pagamento

Estes são os campos de dados recomendados no seu log de eventos para uma análise completa do processamento de pagamentos na Adyen.

5 Obrigatório 7 Recomendado 8 Opcional

	Nome	Descrição
	Event Timestamp EventDate	A data e hora em que ocorreu a atividade específica de pagamento.
Descrição Este atributo registra o timestamp exato de quando um evento foi logado. Ele permite a ordenação cronológica das atividades em cada caso. Na análise, é fundamental para calcular tempos de ciclo, identificar gargalos e medir a produtividade. Ele sustenta KPIs como o 'Tempo Total do Ciclo de Pagamento'. Por que é importante Essencial para ordenar os eventos e calcular todas as métricas baseadas em duração. Onde obter Campo 'eventDate' dos Webhooks de Notificação Adyen. Exemplos 2023-10-27T10:00:00+01:002023-10-27T10:05:30+01:002023-10-28T09:15:00+01:00
	ID da Transação de Pagamento PspReference	O identificador único de referência atribuído pela Adyen a cada transação.
Descrição Este atributo é a chave primária de todo o ciclo na Adyen. Ele liga o pedido inicial a eventos como autorização, captura, liquidação e reembolsos. Na análise, este ID agrupa eventos em um único caso, permitindo reconstruir o processo ponta a ponta. Assim, analistas rastreiam a jornada completa do pagamento, do clique do comprador até o dinheiro cair na conta. Por que é importante É o elo fundamental que agrupa eventos desconectados em uma única instância de processo para análise. Onde obter Resposta de Pagamento Adyen 'pspReference' ou coluna 'PSP Reference' do Relatório de Detalhes de Liquidação. Exemplos 851564567890123479145612345678908825641234567890
	Nome da Atividade EventCode	A etapa ou ação específica ocorrendo no ciclo de vida do pagamento.
Descrição Este atributo define o evento ocorrido, como AUTHORISATION, CAPTURE ou REFUND. Ele dita os nós no mapa do processo e determina o fluxo da transação. Na análise, esses códigos viram nomes de atividades fáceis de ler. Variações na sequência desses códigos indicam caminhos diferentes, como processamento direto versus tratamento de exceções. Por que é importante Define o 'o quê' do modelo de Process Mining, permitindo a visualização dos fluxos do processo. Onde obter Campo 'eventCode' dos Webhooks de Notificação Adyen. Exemplos AUTHORISATIONCAPTUREREEMBOLSO (REFUND)CANCELLATIONCHARGEBACK
	Sistema de Origem SourceSystem	O nome do sistema de onde os dados se originaram.
Descrição Este atributo estático identifica que o registro veio da Adyen. Em Process Mining multi-sistema (ex: Adyen + SAP), isso é crucial para a linhagem dos dados. Na análise, permite filtrar o que aconteceu no gateway de pagamento versus o que ocorreu no ERP ou sistema de gestão de pedidos. Por que é importante Crucial para a linhagem de dados em Process Mining multi-sistemas. Onde obter Valor estático durante a extração. Exemplos AdyenAdyen_Production
	Última Atualização de Dados LastDataUpdate	O registro de data e hora de quando o registro foi extraído ou atualizado pela última vez.
Descrição Este atributo indica a atualização dos dados no modelo. Ajuda a entender se você está vendo dados em tempo real ou um retrato do passado. Na análise, é um campo técnico para governança e validação do funcionamento da pipeline. Por que é importante Campo técnico para monitorar a atualização dos dados. Onde obter Horário do sistema na extração. Exemplos 2023-10-30T12:00:00Z
	Conta de Lojista MerchantAccount	A conta de lojista específica na Adyen que está processando a transação.
Descrição A Adyen permite várias contas de lojista em uma única conta de empresa. Este atributo identifica qual unidade de negócio, marca ou entidade regional processou o pagamento. Na análise, funciona como uma dimensão principal para segmentação. Permite que as partes interessadas comparem o desempenho, as taxas de falha e os volumes entre diferentes unidades para identificar áreas específicas de melhoria. Por que é importante Chave para segmentar o desempenho por unidade de negócio ou subsidiária. Onde obter Solicitação/Resposta de Pagamento Adyen 'merchantAccount'. Exemplos MinhaLoja_UKMinhaLoja_USGlobalSales_Main
	É Retrabalho IsRework	Sinalizador indicando se a transação envolveu novas tentativas ou correções de erros.
Descrição Um sinalizador booleano (true/false) que é verdadeiro se o caso contiver várias tentativas de autorização ou atividades como 'Pagamento Recusado' seguido de uma nova tentativa. Na análise, isso alimenta o dashboard 'Gargalos de Retrabalho e Exceções de Pagamento'. Ele permite que os analistas filtrem especificamente os casos problemáticos para entender por que os fluxos do processo não estão seguindo o caminho ideal (happy path). Por que é importante Identifica casos ineficientes que exigem intervenção manual ou do sistema. Onde obter Calculado com base na ocorrência de eventos de falha > 0. Exemplos verdadeirofalse
	Meio de Pagamento PaymentMethod	O método específico usado pelo comprador, como Visa ou PayPal.
Descrição Este atributo captura o instrumento de pagamento usado, incluindo bandeiras (Visa, MC), carteiras digitais (PayPal, Apple Pay) ou métodos locais. Na análise, isso é vital para o dashboard 'Performance por Método de Pagamento'. Ajuda a correlacionar métodos específicos com taxas de autorização, velocidade de processamento ou falhas técnicas. Por que é importante Fundamental para analisar taxas de sucesso e custos em diferentes provedores de pagamento. Onde obter Resposta de Pagamento Adyen 'paymentMethod.brand' ou 'paymentMethod.type'. Exemplos visamcpaypalidealklarna
	Motivo da Recusa RefusalReason	A descrição em texto explicando por que um pagamento foi recusado ou falhou.
Descrição Quando uma transação falha, a Adyen dá um código ou descrição (ex: 'Saldo insuficiente', 'Cartão expirado'). Na análise, isso alimenta o dashboard de 'Taxa de Falha em Transações'. Analisar esses motivos ajuda a saber se o erro é técnico, de fraude ou comportamento do cliente, orientando ações corretivas. Por que é importante O atributo principal para a análise de causa raiz de pagamentos com falha. Onde obter Resposta de Pagamento Adyen 'refusalReason'. Exemplos RecusadoSaldo insuficienteCartão ExpiradoErro do AdquirenteFraude
	Status do Pagamento PaymentStatus	O estado atual do pagamento (ex: Autorizado, Liquidado, Recusado).
Descrição Este atributo reflete o último status conhecido da transação. Geralmente vem da atividade mais recente do caso. Na análise, permite filtrar casos rapidamente (ex: 'mostrar pagamentos recusados'). É essencial para o dashboard de 'Monitoramento de Status e Produtividade'. Por que é importante Fornece um panorama da saúde atual da transação. Onde obter Derivado do último código de evento no caso. Exemplos LiquidadoRecusadoAuthorised
	Tempo Total do Ciclo de Pagamento TotalCycleTime	A duração total desde a solicitação de pagamento até a liquidação.
Descrição Esta métrica mede o tempo entre a 'Solicitação Recebida' e a 'Liquidação'. Na análise, é o principal KPI de eficiência. Ela mostra a velocidade do fluxo de caixa. Ciclos longos podem indicar problemas com atrasos na captura ou nos ciclos de liquidação. Por que é importante KPI para otimização do capital de giro. Onde obter Calculado: Timestamp(Settled) - Timestamp(Created). Exemplos 2 dias4 horas5 minutos
	Valor da Transação PaymentAmount	O valor monetário da transação de pagamento.
Descrição Este atributo representa o valor da transação. Costuma vir em centavos nos dados brutos, mas deve ser convertido para os relatórios. Na análise, alimenta o dashboard de produtividade e ajuda a priorizar retrabalhos de alto valor. Também serve para calcular o volume total e o impacto financeiro de falhas. Por que é importante Necessário para análise de impacto financeiro e monitoramento de vazão (throughput). Onde obter Solicitação de Pagamento Adyen 'amount.value'. Exemplos 10005509900
	Cód. de Autenticação AuthorisationCode	O código de autorização retornado pelo emissor após a aprovação.
Descrição Um código indicando que os fundos foram reservados no cartão do comprador. Esta é a prova de uma autorização bem-sucedida. Na análise, serve principalmente para auditoria e rastreabilidade. Ele valida que a atividade 'Pagamento Autorizado' foi legítima. Por que é importante Comprovante de autorização bem-sucedida para trilhas de auditoria. Onde obter Resposta de Pagamento Adyen 'authCode'. Exemplos 123456098712
	ID do Cliente ShopperReference	Uma referência exclusiva usada para identificar o comprador em várias transações.
Descrição Este identificador vincula diferentes transações ao mesmo cliente. É fornecido pelo lojista no pedido. Na análise, permite uma visão centrada no cliente, ajudando a detectar reincidentes em fraudes ou clientes fiéis. Facilita o mapeamento genérico de 'Cliente'. Por que é importante Permite a agregação por cliente e a análise de comportamento. Onde obter Solicitação de Pagamento Adyen 'shopperReference'. Exemplos CUST-001usuario_12345email@exemplo.com
	Moeda PaymentCurrency	O código ISO de três letras da moeda da transação.
Descrição Este atributo define a moeda do `PaymentAmount`. Valores comuns incluem BRL, USD, EUR, etc. Na análise, é usado para agrupar transações por mercado e é essencial para normalizar valores financeiros ao agregar dados de diferentes regiões. Por que é importante Contextualiza o campo de valor para relatórios de várias moedas. Onde obter Solicitação de Pagamento Adyen 'amount.currency'. Exemplos EURUSDGBP
	Número do Lote de Liquidação BatchNumber	O número do lote associado à liquidação dos fundos.
Descrição A Adyen agrupa os pagamentos liquidados em lotes para repasse. Este atributo identifica a qual lote uma transação específica pertence. Na análise, isso é usado para agrupar pagamentos por seu ciclo de repasse. Ajuda a auditar se lotes específicos estão atrasados e apoia o rastreamento da atividade 'Pagamento Liquidado'. Por que é importante Vincula transações individuais a liquidações financeiras em lote. Onde obter Coluna 'Batch Number' do Relatório de Detalhes de Liquidação Adyen. Exemplos 100255
	País do Comprador ShopperCountry	O código de país de duas letras do comprador.
Descrição Este atributo indica a localização do comprador, geralmente pelo país do cartão ou endereço de cobrança. Na análise, serve para avaliar a performance regional. Ajuda a ver se certos países têm mais recusas ou atrasos devido à infraestrutura bancária local. Por que é importante Permite a segmentação geográfica do desempenho de pagamentos. Onde obter Solicitação de Pagamento Adyen 'countryCode' ou 'billingAddress.country'. Exemplos NLEUADE
	Referência do Adquirente AcquirerReference	Número de referência fornecido pelo banco adquirente.
Descrição Esta é a referência externa do adquirente que processa o cartão. É diferente da referência PSP da Adyen. Na análise, este campo é crítico para a 'Análise de Atraso na Conciliação'. É a chave usada para cruzar registros da Adyen com extratos bancários em sistemas externos. Por que é importante Essencial para a conciliação de três vias (3-way matching) e reconciliação externa. Onde obter Resposta de Pagamento Adyen 'additionalData.acquirerReference'. Exemplos 1234567890987654321
	Score de Risco de Fraude RiskScore	O score de risco atribuído à transação pelo motor de fraude.
Descrição O motor RevenueProtect da Adyen atribui uma pontuação numérica (0-100) indicando a probabilidade de fraude. Pontuações mais altas costumam acionar revisão manual ou bloqueio automático. Na análise, isso auxilia na 'Visão Geral de Risco de Conformidade Financeira'. Correlacionar scores de alto risco com chargebacks ajuda a ajustar as regras de fraude. Scores altos que resultam em pagamentos bem-sucedidos podem indicar falsos positivos no modelo de risco. Por que é importante Essencial para analisar a eficiência da lógica de prevenção a fraudes. Onde obter Resposta da API de Risco da Adyen ou campo 'fraudResult.accountScore' de relatórios. Exemplos 025100
	Tipo de Interação do Comprador ShopperInteraction	Indica se o pagamento foi via E-commerce, POS ou uma assinatura (ContAuth).
Descrição Este atributo categoriza a interação entre o comprador e o lojista. Valores típicos são `Ecommerce`, `POS` (loja física) ou `ContAuth` (recorrência). Na análise, ajuda a distinguir canais de venda e modelos de negócio. Como os fluxos mudam muito entre POS e Ecommerce, este filtro é essencial para uma descoberta de processo clara. Por que é importante Diferencia os fluxos de processo entre pagamentos online, presenciais (POS) e recorrentes. Onde obter Solicitação de Pagamento Adyen 'shopperInteraction'. Exemplos E-commerceContAuthPOSMoto

Obrigatório Recomendado Opcional

Atividades de Processamento de Pagamento

Estas são as etapas e marcos fundamentais para capturar no seu log de eventos e garantir a descoberta precisa dos seus fluxos na Adyen.

5 Recomendado 11 Opcional

	Atividade	Descrição
	Pagamento Autorizado	O emissor ou método de pagamento aprovou a transação e os fundos estão reservados. Capturado via webhook de notificação padrão da Adyen.
Por que é importante Um marco crítico que indica que a transação é válida e os fundos estão disponíveis. É o pré-requisito para a captura. Onde obter Webhook de Notificação Adyen: eventCode 'AUTHORISATION' com success='true'. Captura Registrado no sucesso do webhook de AUTHORISATION Tipo de evento explicit
	Pagamento Capturado	O comando para transferir fundos do comprador para o lojista foi processado. Pode ser imediato (captura automática) ou postergado (captura manual).
Por que é importante Confirma o reconhecimento de receita. O tempo entre a Autorização e a Captura é fundamental para o KPI 'Lead Time de Autorização de Pagamento'. Onde obter Webhook de Notificação Adyen: eventCode 'CAPTURE' com success='true'. Captura Registrado no sucesso do webhook de CAPTURE Tipo de evento explicit
	Pagamento Liquidado	Os fundos foram compensados e creditados com sucesso na conta Adyen do lojista. Isso aparece no Relatório de Detalhes de Liquidação.
Por que é importante A conclusão financeira do processo. Essencial para o 'Tempo Total do Ciclo de Pagamento' e a 'Análise de Atraso na Conciliação'. Onde obter Relatório de Detalhes de Liquidação Adyen (SDR), tipo de registro 'Settled'. Captura Registrado quando a transação aparece no Relatório de Liquidação Tipo de evento explicit
	Pagamento Recusado	A transação foi recusada pelo emissor ou pelas regras de risco da Adyen. Capturado via webhook de autorização com status de falha.
Por que é importante Impacta diretamente o KPI 'Taxa de Falha de Transação de Pagamento'. A análise dos motivos de recusa ajuda a otimizar as taxas de autorização. Onde obter Webhook de Notificação Adyen: eventCode 'AUTHORISATION' com success='false'. Captura Registrado na falha do webhook de AUTHORISATION Tipo de evento explicit
	Solicitação de Pagamento Recebida	O recebimento inicial da solicitação pela Adyen. Capturado a partir do timestamp da API ou da criação do pspReference.
Por que é importante Marca o início absoluto da instância do processo. Essencial para calcular o tempo total do ciclo de ponta a ponta. Onde obter Logs da API de Pagamento Adyen ou o carimbo de data/hora associado à criação do pspReference. Captura Registrado quando o pspReference é gerado via API Tipo de evento explicit
	Chargeback Defendido	As evidências foram enviadas à Adyen para contestar um chargeback. Isso representa uma atividade manual ou de retrabalho no fluxo de disputa.
Por que é importante Monitora o esforço em proteção de receita. Importante para a 'Taxa de Retrabalho'. Onde obter API de Disputas da Adyen ou logs de Gestão de Casos mostrando o envio de evidências. Captura Inferido pela mudança de status para 'Defense Supplied' (Defesa Fornecida) Tipo de evento inferred
	Chargeback Estornado	A disputa foi vencida e os fundos retornaram ao lojista. Representa a resolução bem-sucedida de uma exceção.
Por que é importante Resultado positivo para a gestão de riscos. Compensa o impacto financeiro do chargeback inicial. Onde obter Webhook de Notificação Adyen: eventCode 'CHARGEBACK_REVERSED'. Captura Registrado no webhook de CHARGEBACK_REVERSED Tipo de evento explicit
	Erro Técnico Registrado	Ocorreu um erro de sistema durante o processamento, como falha no webhook ou timeout da API. Identificado por meio de códigos de erro específicos na interface.
Por que é importante Apoia diretamente a análise da 'Taxa de Falha de Transação de Pagamento' ao categorizar falhas técnicas vs. financeiras. Onde obter Logs da Interface Adyen ou respostas de falha específicas em chamadas de API. Captura Registrado quando um código de erro 5xx ou 4xx é retornado Tipo de evento explicit
	Falha na Captura	A tentativa de capturar fundos autorizados falhou, geralmente por timeout técnico ou mudança no status do cartão entre a autorização e a captura.
Por que é importante Ponto de erro crítico que exige retrabalho ou nova tentativa. Contribui para a 'Taxa de Exceção de Pagamento'. Onde obter Webhook de Notificação Adyen: eventCode 'CAPTURE_FAILED'. Captura Registrado no webhook de CAPTURE_FAILED Tipo de evento explicit
	Notificação de Chargeback Recebida	A Adyen recebeu uma notificação de disputa da bandeira do cartão. Isso aciona o workflow de disputa.
Por que é importante Importante indicador de conformidade e risco. Alimenta a 'Taxa de Incidentes de Conformidade' e exige intervenção manual imediata. Onde obter Webhook de Notificação Adyen: eventCode 'CHARGEBACK' ou 'NOTIFICATION_OF_CHARGEBACK'. Captura Registrado no webhook de CHARGEBACK Tipo de evento explicit
	Pagamento Cancelado	A autorização foi cancelada antes da captura dos fundos, liberando o valor reservado no cartão do comprador.
Por que é importante Representa um loop no processo onde um pedido válido é interrompido antes da conclusão, geralmente por solicitação do cliente ou falta de estoque. Onde obter Webhook de Notificação Adyen: eventCode 'CANCELLATION'. Captura Registrado no webhook de CANCELLATION Tipo de evento explicit
	Pagamento Confirmado	Os fundos associados a um lote de transações liquidadas foram pagos na conta bancária do lojista.
Por que é importante Representa a transferência real de dinheiro para a empresa, vinculada ao 'Tempo do Ciclo de Conciliação de Pagamentos'. Onde obter Webhook de Notificação Adyen: eventCode 'PAYOUT_THIRD_PARTY' ou inferido do Relatório de Payout. Captura Unir o ID do lote do Relatório de Repasse ao ID da Transação Tipo de evento inferred
	Pagamento Enviado para Liquidação	A Adyen encaminhou a transação para o banco adquirente ou rede para processamento financeiro. O status muda para SentForSettlement (Enviado para Liquidação).
Por que é importante Marca a transição do processamento operacional para a compensação financeira. Atrasos aqui afetam o fluxo de caixa. Onde obter API de Status de Transação da Adyen ou inferido de logs de histórico de mudança de status. Captura Comparar a transição do campo de status para SentForSettlement Tipo de evento inferred
	Reembolso Iniciado	Uma solicitação de devolução de fundos ao comprador foi acionada. Isso inicia um fluxo de processo reverso.
Por que é importante Indica uma exceção após a liquidação. Altas taxas de reembolso podem indicar problemas de qualidade em etapas anteriores. Onde obter Webhook de Notificação Adyen: eventCode 'REFUND'. Captura Registrado no acionamento do webhook de REFUND Tipo de evento explicit
	Reembolso Liquidado	O reembolso foi processado financeiramente e debitado da conta do lojista. Confirmado via Settlement Detail Report.
Por que é importante Encerra o ciclo do processo de reembolso. Importante para o KPI 'Tempo Médio de Resolução de Erros' se o reembolso foi devido a um erro. Onde obter Relatório de Detalhes de Liquidação Adyen, tipo de registro 'Refunded' ou 'RefundedReversed'. Captura Registrado quando o reembolso aparece no Relatório de Liquidação Tipo de evento explicit
	Triagem de Risco Realizada	O motor RevenueProtect da Adyen analisa a transação em busca de sinais de fraude. Isso é inferido pela presença de um score de fraude ou resultado de risco na resposta da autorização.
Por que é importante Scores de alto risco podem desencadear revisões manuais ou recusas automáticas, criando gargalos ou pontos de interrupção no processo. Onde obter Resposta de Pagamento Adyen (campo fraudResult) ou logs de Gestão de Casos. Captura Inferido pela presença do objeto fraudResult Tipo de evento inferred

Recomendado Opcional

Guias de Extração

Como obter seus dados da Adyen

Etapas

Faça login na Área do Cliente Adyen com uma conta de usuário que tenha a função Merchant Report.
Navegue até Reports e selecione Settlement details no menu.
Localize as configurações de Automatic generation ou escolha Generate report para uma exportação única.
No painel de configuração, certifique-se de que o Format esteja definido como CSV (valores separados por vírgula).
Em Include columns, selecione All ou marque especificamente: 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 e Interchange.
IMPORTANTE: Garanta que o escopo do relatório inclua todos os Journal Types (Settled, Refunded, Chargeback, PaidOut, etc.) para capturar o ciclo de vida financeiro completo.
Gere o relatório para o intervalo de datas desejado (ex: últimos 90 dias). Note que os relatórios de liquidação são gerados com base na data do lote de liquidação, não na data da transação.
Baixe o arquivo CSV gerado para o seu ambiente de extração local.
Execute o script de transformação (fornecido abaixo) para remodelar o registro CSV 'Largo' no formato de Log de Eventos 'Longo' exigido pelo ProcessMind.
O script realiza transformações críticas: ele faz o unpivot da Creation Date para criar eventos de 'Solicitação de Pagamento Recebida' e mapeia a coluna Type para atividades financeiras específicas.
Verifique se o CSV de saída contém os cabeçalhos: PspReference, EventCode, EventDate, SourceSystem.
Carregue o CSV final transformado no ProcessMind.

Configuração

Tipo de Relatório: Relatório de Detalhes de Liquidação (Settlement Detail Report - razão financeiro)
Formato do Arquivo: CSV (separação padrão por vírgula)
Granularidade: Nível de Transação (uma linha por entrada de diário financeiro)
Fuso Horário: UTC (fortemente recomendado para alinhar a extração com outros sistemas)
Intervalo de Datas: Alinhado com os Lotes de Liquidação (Data de Fechamento do Lote), não com a Data de Criação da Transação. Garanta que as sobreposições sejam tratadas se a execução for incremental.
Colunas Obrigatórias: Psp Reference (Chave), Type (Atividade), Creation Date, Booking Date (Timestamps do Evento), Merchant Account.
Configurações de Filtro: Certifique-se de que nenhum filtro exclua os tipos 'Chargeback' ou 'Reembolso' para garantir a integridade do processo.

a Consulta de Exemplo 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}')

Etapas

Configuração de Pré-requisitos: Certifique-se de ter um usuário de relatório da Adyen com a função Merchant Report ativada. Obtenha sua API Key na Área do Cliente em Desenvolvedores > Credenciais de API.
Identificar Relatórios Necessários: Esta extração depende de dois relatórios CSV principais gerados pela Adyen: o Relatório de Detalhes de Liquidação (para eventos financeiros como Liquidação, Chargebacks, Reembolsos) e o Relatório de Detalhes de Pagamentos Recebidos (para eventos operacionais como Solicitações, Recusas, Autorizações).
Configuração do Ambiente Python: Instale as bibliotecas necessárias usando o pip: pandas, requests e numpy. Elas serão usadas para comunicação com a API e transformação de dados.
Implementação da Conexão com API: Configure o script Python (fornecido abaixo) para autenticar nos endpoints https://management-test.adyen.com ou https://management-live.adyen.com. Você usará a Report API para listar os relatórios disponíveis para o intervalo de datas específico e baixar as URLs.
Ingestão de Dados: O script lê os dados brutos do CSV em DataFrames do pandas. Os relatórios da Adyen são tipicamente 'largos' (uma linha por transação com várias colunas de status), por isso a transformação é necessária.
Mapeamento de Atividades - Operacional: Processe o Relatório de Detalhes de Pagamentos Recebidos. Mapeie a CreationDate como Solicitação de Pagamento Recebida. Use a lógica para inspecionar a coluna Status (ex: Autorizado, Recusado, Erro) para gerar eventos como Pagamento Autorizado, Pagamento Recusado ou Erro Técnico Registrado.
Mapeamento de Atividades - Financeiro: Processe o Relatório de Detalhes de Liquidação. Este relatório contém uma coluna JournalType. Mapeie valores como Settled para Pagamento Liquidado, Refunded para Reembolso Iniciado e Chargeback para Notificação de Chargeback Recebida.
Inferindo Atividades Complexas:
- Análise de Risco Realizada: Verifique se a coluna FraudScore está preenchida e é maior que -1.
- Pagamento Efetuado Confirmado: Vincule as transações via BatchNumber à entrada de Payout no relatório de liquidação.
- Chargeback Defendido: Procure pelos tipos de diário SecondChargeback ou Defense.
Transformação de Dados: Aplique uma operação de 'melt' ou 'stack' no pandas para converter o conjunto de dados largo para o formato de log de eventos longo, onde cada atividade é uma linha separada.
Padronização de Atributos: Renomeie as colunas para corresponder ao esquema de destino: PspReference, EventCode, EventDate, SourceSystem (fixo como 'Adyen') e PaymentAmount. Garanta que as datas sejam analisadas no formato ISO 8601.
Filtragem: Filtre as linhas de reconciliação interna que não representam etapas do processo (como linhas de cabeçalho ou transferências de saldo) usando o filtro Type.
Exportação Final: O script exporta o DataFrame processado para um arquivo CSV chamado adyen_event_log.csv, pronto para ser carregado no ProcessMind.

Configuração

Ambiente de API: Alterne entre os endpoints de teste (management-test.adyen.com) e produção (management-live.adyen.com) da Adyen conforme a fase de implementação.
Autenticação: Utilize x-api-key no cabeçalho. Não utilize Basic Auth para a Management API.
Tipos de Relatório:
- settlement_detail_report: Crucial para eventos do ciclo de vida financeiro.
- received_payment_detail_report: Crucial para a solicitação inicial e lógica de autorização.
Intervalo de Datas: Os relatórios da Adyen são gerados com base no fechamento do lote. Garanta que o script solicite relatórios que cubram a CreationDate de interesse + 7 dias para capturar liquidações atrasadas.
Escopo da Conta de Lojista: Se você tiver várias contas de lojista, itere pela lista de contas ou use o relatório de nível de Conta de Empresa (Company Account), se disponível.
Configuração do Pandas: Certifique-se de que low_memory=False esteja definido ao ler arquivos CSV se o volume de transações ultrapassar 100 mil linhas, evitando erros de inferência de tipo.

a Consulta de Exemplo 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.')

Seu Template de Dados de Processamento de Pagamentos

Seu Template de Dados de Processamento de Pagamentos

Atributos de Processamento de Pagamento

Atividades de Processamento de Pagamento

Guias de Extração

Exportação do Relatório de Detalhes de Liquidação Adyen

Etapas

Configuração

a Consulta de Exemplo config

Extração via Python usando Reporting API

Etapas

Configuração

a Consulta de Exemplo python

Pronto para Começar?

Garanta um processamento de pagamentos fluido na Adyen hoje mesmo.

Seu Template de Dados de Processamento de Pagamentos

Seu Template de Dados de Processamento de Pagamentos

Atributos de Processamento de Pagamento

Atividades de Processamento de Pagamento

Guias de Extração

Exportação do Relatório de Detalhes de Liquidação Adyen

Etapas

Configuração

a Consulta de Exemplo config

Extração via Python usando Reporting API

Etapas

Configuração

a Consulta de Exemplo python

Valorizamos sua privacidade

Pronto para Começar?

Garanta um processamento de pagamentos fluido na Adyen hoje mesmo.