> Melhoria contínua de processos > Processamento de pagamentos > Adyen > Template de dados

Seu Template de dados de processamento de pagamentos

Adyen

Atributos do processamento de pagamentos (19) Atividades do processamento de pagamentos (16) Guias de extração (2)

Seu Template de dados de processamento de pagamentos

Este Template oferece um guia completo para coletar os dados necessários à análise do processamento de pagamentos na Adyen. Ele apresenta os atributos de dados essenciais e as atividades do processo que você deve acompanhar, além de instruções práticas para extrair os dados. Use-o para garantir que você capture todas as informações importantes para uma mineração de processos eficaz.

Atributos recomendados para coleta
Principais atividades a acompanhar
Orientações práticas para extração de dados da Adyen

Novidade em Event Logs? Saiba como criar um Event Log para Process Mining.

Baixar Template

Atributos do processamento de pagamentos

Estes são os campos de dados recomendados para incluir no seu Event Log e analisar detalhadamente o processamento de pagamentos na Adyen.

5 Obrigatório 6 Recomendado 8 Opcional

	Nome	Descrição
	Data e hora do evento EventDate	Data e hora em que a atividade de pagamento ocorreu.
Descrição Este atributo registra a data e hora exatas em que um evento, como uma autorização ou liquidação, foi registrado no sistema. Isso permite ordenar cronologicamente as atividades de um caso. Na análise, esse dado é essencial para calcular tempos de ciclo, identificar gargalos e determinar o volume processado pelo sistema ao longo do tempo. Ele dá suporte a todos os KPIs baseados em tempo, como “Tempo de ciclo geral do pagamento”. Por que isso importa Essencial para ordenar eventos e calcular todas as métricas baseadas em duração. Onde encontrar Campo 'eventDate' dos Adyen Notification Webhooks. 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	Identificador de referência exclusivo que o Adyen atribui a cada transação de pagamento.
Descrição Este atributo funciona como chave primária de todo o ciclo de vida do pagamento no ecossistema Adyen. Ele conecta a solicitação inicial de pagamento a eventos posteriores, como autorização, captura, liquidação e possíveis reembolsos ou contestações. Na análise, esse ID agrupa eventos distintos em um único caso e permite reconstruir o processo de ponta a ponta. Com ele, os analistas acompanham o caminho específico de um pagamento, desde a solicitação do cliente até a liquidação financeira final. Por que isso importa É o vínculo fundamental que reúne eventos desconectados em uma única instância de processo para a mineração. Onde encontrar Resposta de pagamento do Adyen, campo 'pspReference', ou coluna 'PSP Reference' do Settlement Detail Report. Exemplos 851564567890123479145612345678908825641234567890
	Nome da atividade EventCode	Etapa ou ação específica que ocorre no ciclo de vida do pagamento.
Descrição Este atributo define o evento específico ocorrido, como AUTHORISATION, CAPTURE ou REFUND. Ele determina os nós do mapa de processos e define o fluxo da transação. Na análise, esses códigos são convertidos em nomes de atividades compreensíveis para visualizar o fluxo do processo. As variações na sequência dos códigos indicam diferentes caminhos do processo, como o processamento direto ou o tratamento de exceções. Por que isso importa Define o “o quê” do modelo de Process Mining e permite visualizar os fluxos do processo. Onde encontrar Campo 'eventCode' dos Adyen Notification Webhooks. Exemplos AUTHORISATIONCAPTUREREFUNDCANCELLATIONCHARGEBACK
	Sistema de origem SourceSystem	Nome do sistema de onde os dados vieram.
Descrição Este atributo estático identifica que o registro veio da Adyen. Em Process Mining com vários sistemas, como Adyen e SAP, ele é essencial para rastrear a origem dos dados. Na análise, permite filtrar atividades que ocorreram especificamente no gateway de pagamento, em vez de no ERP ou no sistema de gestão de pedidos. Por que isso importa Essencial para rastrear a origem dos dados em Process Mining com vários sistemas. Onde encontrar Valor estático durante a extração. Exemplos AdyenAdyen_Production
	Última atualização dos dados LastDataUpdate	Data e hora da última extração ou atualização do registro.
Descrição Este atributo indica o nível de atualização dos dados no modelo de Process Mining. Ele ajuda a entender se você está analisando dados em tempo real ou um instantâneo. Na análise, é um campo principalmente técnico, usado na governança de dados e para verificar se o pipeline está funcionando corretamente. Por que isso importa Campo técnico para acompanhar a atualização dos dados. Onde encontrar Horário do sistema no momento da extração. Exemplos 2023-10-30T12:00:00Z
	Conta do estabelecimento MerchantAccount	Conta específica do estabelecimento usada para processar a transação na Adyen.
Descrição A Adyen permite várias contas de estabelecimento vinculadas a uma única conta da empresa. Este atributo identifica qual unidade de negócio, marca ou entidade regional processou o pagamento. Na análise, ele funciona como uma dimensão principal para segmentação. Assim, as partes interessadas podem comparar performance, taxas de falha e volumes entre diferentes unidades de negócio ou marcas e identificar áreas específicas que precisam de melhorias. Por que isso importa Essencial para segmentar a performance por unidade de negócio ou subsidiária. Onde encontrar 'merchantAccount' da solicitação/resposta de pagamento da Adyen. Exemplos MyStore_UKMyStore_USGlobalSales_Main
	É retrabalho IsRework	Indicador de que a transação envolveu novas tentativas ou correções de erros.
Descrição Indicador booleano que assume o valor verdadeiro quando o caso contém várias tentativas de autorização ou atividades como “Pagamento recusado” seguidas de uma nova tentativa. Na análise, esse indicador alimenta o Dashboard “Pontos críticos de retrabalho e exceções em pagamentos”. Ele permite que analistas filtrem casos problemáticos para entender por que os fluxos do processo não seguem o caminho ideal. Por que isso importa Identifica casos ineficientes que exigem intervenção manual ou do sistema. Onde encontrar Calculado com base na ocorrência de mais de zero eventos de falha. Exemplos truefalse
	Método de pagamento PaymentMethod	Método usado pelo comprador para pagar, como Visa ou PayPal.
Descrição Este atributo registra o tipo de instrumento de pagamento usado, como bandeiras de cartão de crédito (Visa, MC), carteiras digitais (PayPal, Apple Pay) ou métodos de pagamento locais (iDEAL, Sofort). Na análise, ele é fundamental para o Dashboard “Insights de performance por método de pagamento”. Ajuda a identificar relações entre métodos de pagamento específicos e taxas de autorização, velocidade de processamento ou falhas técnicas. Por que isso importa Fundamental para analisar taxas de sucesso e custos entre diferentes provedores de pagamento. Onde encontrar 'paymentMethod.brand' ou 'paymentMethod.type' da resposta de pagamento da Adyen. Exemplos visamcpaypalidealklarna
	Motivo da recusa RefusalReason	Descrição do motivo pelo qual um pagamento foi recusado ou falhou.
Descrição Quando uma transação falha, a Adyen informa um código ou uma descrição do motivo, como “Saldo insuficiente”, “CVC recusado” ou “Cartão vencido”. Na análise, esse é o principal indicador do Dashboard “Taxa de falha nas transações de pagamento”. Analisar esses motivos ajuda a identificar se as falhas decorrem de problemas técnicos, regras antifraude ou comportamento do comprador, orientando ações corretivas específicas. Por que isso importa Atributo essencial para a análise de causa raiz de pagamentos com falha. Onde encontrar 'refusalReason' da resposta de pagamento da Adyen. Exemplos RecusadoSaldo insuficienteCartão vencidoErro do adquirenteFraude
	Status do pagamento PaymentStatus	Estado atual do pagamento, como autorizado, liquidado ou recusado.
Descrição Este atributo mostra o status mais recente conhecido da transação de pagamento. Em geral, ele é definido pela atividade mais recente do caso. Na análise, permite filtrar casos rapidamente, por exemplo, para mostrar todos os pagamentos atualmente recusados. É essencial para o Dashboard “Monitoramento do volume e do status dos pagamentos”. Por que isso importa Apresenta um retrato da situação atual da transação. Onde encontrar Derivado do último código de evento do caso. Exemplos LiquidadoRecusadoAutorizado
	Valor da transação PaymentAmount	Valor monetário da transação de pagamento.
Descrição Este atributo representa o valor financeiro associado à transação. Nos dados brutos, ele costuma ser armazenado em unidades menores, como centavos, mas deve ser convertido para a geração de relatórios. Na análise, ele permite criar o Dashboard “Volume de pagamentos” e ajuda a priorizar casos de retrabalho de alto valor. Também é usado para calcular o volume total processado e o impacto financeiro das transações com falha. Por que isso importa Necessário para analisar o impacto financeiro e monitorar o volume processado. Onde encontrar 'amount.value' da solicitação de pagamento da Adyen. Exemplos 10005509900
	Código de autorização AuthorisationCode	Código de autorização retornado pelo emissor após a aprovação.
Descrição Código que indica que os valores foram reservados no cartão do comprador. É a comprovação de que a autorização foi bem-sucedida. Na análise, ele é usado principalmente para auditoria e rastreabilidade. Valida se a atividade “Pagamento autorizado” foi legítima. Por que isso importa Comprova a autorização bem-sucedida para fins de auditoria. Onde encontrar 'authCode' da resposta de pagamento da Adyen. Exemplos 123456098712
	ID do cliente ShopperReference	Referência exclusiva usada para identificar o comprador em várias transações.
Descrição Este identificador vincula diferentes transações ao mesmo cliente. O estabelecimento o informa na solicitação de pagamento. Na análise, ele permite uma visão centrada no cliente e ajuda a identificar reincidências em casos de fraude ou clientes fiéis entre as transações bem-sucedidas. Também facilita o mapeamento genérico “Cliente”. Por que isso importa Permite agregar dados por cliente e analisar seu comportamento. Onde encontrar 'shopperReference' da solicitação de pagamento da Adyen. Exemplos CUST-001user_12345email@example.com
	Moeda PaymentCurrency	Código ISO de três letras que identifica a moeda da transação.
Descrição Este atributo define a moeda em que o `PaymentAmount` é expresso. Alguns valores comuns são EUR, USD e GBP. Na análise, ele é usado para agrupar transações por mercado e é essencial para padronizar os valores financeiros ao agregar dados de diferentes regiões. Por que isso importa Dá contexto ao campo de valor em relatórios com várias moedas. Onde encontrar 'amount.currency' da solicitação de pagamento da Adyen. Exemplos EURUSDGBP
	Número do lote de liquidação BatchNumber	Número do lote associado à liquidação dos valores.
Descrição A Adyen agrupa os pagamentos liquidados em lotes para repasse. Este atributo identifica a qual lote uma transação pertence. Na análise, ele é usado para agrupar pagamentos por ciclo de repasse. Ajuda a verificar se determinados lotes estão atrasados e dá suporte ao acompanhamento da atividade “Pagamento liquidado”. Por que isso importa Vincula transações individuais a liquidações financeiras em lote. Onde encontrar 'Batch Number' do relatório de detalhes de liquidação da Adyen. Exemplos 100255
	País do comprador ShopperCountry	Código de duas letras do país do comprador.
Descrição Este atributo indica a localização do comprador, geralmente identificada pelo país emissor do cartão ou pelo endereço de cobrança. Na análise, é usado para avaliar a performance por região. Ajuda a identificar se determinados países têm taxas de recusa mais altas ou tempos de processamento maiores devido à infraestrutura bancária local. Por que isso importa Permite segmentar geograficamente a performance dos pagamentos. Onde encontrar 'countryCode' ou 'billingAddress.country' da solicitação de pagamento da Adyen. Exemplos NLUSDE
	Pontuação de risco de fraude RiskScore	Pontuação de risco atribuída à transação pelo mecanismo antifraude.
Descrição O mecanismo RevenueProtect da Adyen atribui uma pontuação numérica de 0 a 100 que indica a probabilidade de fraude. Pontuações mais altas costumam levar a uma análise manual ou ao bloqueio automático. Na análise, esse dado dá suporte à “Visão geral do risco de conformidade financeira”. Relacionar pontuações de risco altas a chargebacks ajuda a ajustar as regras antifraude. Pontuações altas em pagamentos aprovados podem indicar falsos positivos no modelo de risco. Por que isso importa Essencial para analisar a eficiência das regras de prevenção a fraudes. Onde encontrar Resposta da API de risco da Adyen ou campo 'fraudResult.accountScore' dos relatórios. Exemplos 025100
	Referência do adquirente AcquirerReference	Número de referência fornecido pelo banco adquirente.
Descrição Esta é a referência externa atribuída pela instituição financeira responsável por processar a transação com cartão, chamada de adquirente. Ela é diferente da referência PSP da Adyen. Na análise, este campo é essencial para a “Análise de atrasos na conciliação de pagamentos”. Ele é usado para comparar os registros da Adyen com os extratos bancários nos registros externos. Por que isso importa Essencial para a conciliação em três vias e a conciliação externa. Onde encontrar 'additionalData.acquirerReference' da resposta de pagamento da Adyen. Exemplos 1234567890987654321
	Tipo de interação do comprador ShopperInteraction	Indica se o pagamento foi feito no comércio eletrônico, no ponto de venda (POS) ou por assinatura (ContAuth).
Descrição Este atributo classifica a natureza da interação entre o comprador e o estabelecimento. Os valores mais comuns são `Ecommerce` (online), `POS` (na loja) e `ContAuth` (recorrente/assinatura). Na análise, ele ajuda a diferenciar modelos de negócio e canais de venda. Os fluxos do processo costumam variar bastante entre POS e comércio eletrônico, por isso esse atributo é um filtro importante para descobrir o processo com clareza. Por que isso importa Diferencia os fluxos de pagamento online, na loja e recorrentes. Onde encontrar 'shopperInteraction' da solicitação de pagamento da Adyen. Exemplos Comércio eletrônicoContAuthPOSMoto

Obrigatório Recomendado Opcional

Atividades do processamento de pagamentos

Estas são as principais etapas e marcos do processo que você deve registrar no Event Log para descobrir com precisão o fluxo de pagamentos na Adyen.

5 Recomendado 11 Opcional

	Atividade	Descrição
	Pagamento autorizado	O emissor do cartão ou o método de pagamento aprovou a transação e os recursos foram reservados. O evento é capturado pelo webhook padrão de notificações do Adyen.
Por que isso importa Marco importante que indica que a transação é válida e que há recursos disponíveis. É uma condição necessária para a captura. Onde encontrar Webhook de notificações do Adyen: eventCode 'AUTHORISATION' com success='true'. Coleta Registrado quando o webhook AUTHORISATION confirma o sucesso Tipo de evento explicit
	Pagamento capturado	A ordem para transferir os recursos do cliente para o estabelecimento foi processada com sucesso. A captura pode ser imediata (captura automática) ou posterior (captura manual).
Por que isso importa Confirma o reconhecimento da receita. O intervalo entre a autorização e a captura é essencial para o KPI 'Tempo de processamento da autorização de pagamento'. Onde encontrar Webhook de notificações do Adyen: eventCode 'CAPTURE' com success='true'. Coleta Registrado quando o webhook CAPTURE confirma o sucesso Tipo de evento explicit
	Pagamento liquidado	Os recursos foram compensados com sucesso e creditados na conta Adyen do estabelecimento. Esse evento aparece no Settlement Detail Report.
Por que isso importa Conclusão financeira de um processo bem-sucedido. É essencial para os indicadores 'Tempo total do ciclo de pagamento' e 'Análise do atraso na conciliação de pagamentos'. Onde encontrar Settlement Detail Report (SDR) do Adyen, tipo de registro 'Settled'. Coleta Registrado quando a transação aparece no Settlement Report Tipo de evento explicit
	Pagamento recusado	O emissor ou as regras de risco do Adyen recusaram a transação. O evento é capturado pelo webhook de autorização com status de falha.
Por que isso importa Afeta diretamente o KPI 'Taxa de falha de transações de pagamento'. Analisar os motivos das recusas ajuda a otimizar as taxas de autorização. Onde encontrar Webhook de notificações do Adyen: eventCode 'AUTHORISATION' com success='false'. Coleta Registrado quando o webhook AUTHORISATION indica falha Tipo de evento explicit
	Solicitação de pagamento recebida	Registro inicial da solicitação de transação pela plataforma de pagamentos Adyen. Esse evento é identificado pela data e hora da solicitação inicial à API ou pela criação do pspReference.
Por que isso importa Marca o início exato da instância do processo. É essencial para calcular o tempo total do ciclo de ponta a ponta. Onde encontrar Registros da API de pagamentos do Adyen ou data e hora associadas à criação do pspReference. Coleta Registrado quando o pspReference é gerado pela API Tipo de evento explicit
	Contestação defendida	Foram enviadas evidências ao Adyen para contestar uma disputa de pagamento. Isso representa uma atividade manual de retrabalho no fluxo de contestação.
Por que isso importa Registra o esforço dedicado à proteção da receita. É importante para a 'Taxa de retrabalho em pagamentos'. Onde encontrar API de disputas do Adyen ou registros do Case Management que mostram o envio de evidências. Coleta Inferido pela mudança de status para 'Defense Supplied' Tipo de evento inferred
	Contestação revertida	A disputa foi vencida e os recursos foram devolvidos ao estabelecimento. Essa é a resolução bem-sucedida de uma exceção.
Por que isso importa Resultado positivo para a gestão de riscos. Compensa o impacto financeiro da contestação inicial. Onde encontrar Webhook de notificações do Adyen: eventCode 'CHARGEBACK_REVERSED'. Coleta Registrado quando o webhook CHARGEBACK_REVERSED é recebido Tipo de evento explicit
	Erro técnico registrado	Ocorreu um erro de sistema durante o processamento, como uma falha de webhook ou um tempo limite da API. O erro é identificado por códigos específicos na interface.
Por que isso importa Ajuda diretamente na análise da 'Taxa de falha de transações de pagamento', diferenciando falhas técnicas de financeiras. Onde encontrar Registros da interface do Adyen ou respostas de falha específicas nas chamadas à API. Coleta Registrado quando é retornado um código de resposta de erro 5xx ou 4xx Tipo de evento explicit
	Falha na captura	A tentativa de capturar os recursos autorizados falhou, muitas vezes por um tempo limite técnico ou por uma mudança no status do cartão entre a autorização e a captura.
Por que isso importa Ponto crítico de erro que exige retrabalho ou uma nova tentativa. Contribui para a 'Taxa de exceções de pagamento'. Onde encontrar Webhook de notificações do Adyen: eventCode 'CAPTURE_FAILED'. Coleta Registrado quando o webhook CAPTURE_FAILED é recebido Tipo de evento explicit
	Notificação de contestação recebida	O Adyen recebeu uma notificação de contestação da bandeira do cartão. Isso inicia o fluxo de trabalho de contestação.
Por que isso importa É um indicador importante de risco e conformidade. Afeta a 'Taxa de incidentes de conformidade' e exige intervenção manual imediata. Onde encontrar Webhook de notificações do Adyen: eventCode 'CHARGEBACK' ou 'NOTIFICATION_OF_CHARGEBACK'. Coleta Registrado quando o webhook CHARGEBACK é recebido Tipo de evento explicit
	Pagamento cancelado	A autorização foi anulada antes da captura dos recursos. Isso libera os recursos reservados no cartão do cliente.
Por que isso importa Representa um ciclo do processo em que um pedido válido é encerrado antes da conclusão, geralmente por solicitação do cliente ou por expiração do prazo de reserva do estoque. Onde encontrar Webhook de notificações do Adyen: eventCode 'CANCELLATION'. Coleta Registrado quando o webhook CANCELLATION é recebido Tipo de evento explicit
	Pagamento enviado para liquidação	O Adyen encaminhou a transação ao banco adquirente ou à rede para processamento financeiro. O status muda para SentForSettlement.
Por que isso importa Marca a transição do processamento operacional para a compensação financeira. Atrasos nessa etapa afetam o fluxo de caixa. Onde encontrar API de status de transações do Adyen ou inferência com base nos registros do histórico de alterações de status. Coleta Compare a mudança do campo de status para SentForSettlement Tipo de evento inferred
	Reembolso iniciado	Uma solicitação para devolver os recursos ao cliente foi iniciada. Isso dá início ao fluxo inverso do processo.
Por que isso importa Indica uma exceção após a liquidação. Uma taxa alta de reembolsos pode apontar problemas de qualidade nas etapas anteriores. Onde encontrar Webhook de notificações do Adyen: eventCode 'REFUND'. Coleta Registrado quando o webhook REFUND é acionado Tipo de evento explicit
	Reembolso liquidado	O reembolso foi processado financeiramente e debitado da conta do estabelecimento. A confirmação é feita pelo Settlement Detail Report.
Por que isso importa Encerra o ciclo do processo de reembolso. É importante para o 'Tempo médio de resolução de erros' quando o reembolso ocorre por causa de um erro. Onde encontrar Settlement Detail Report do Adyen, tipo de registro 'Refunded' ou 'RefundedReversed'. Coleta Registrado quando o reembolso aparece no Settlement Report Tipo de evento explicit
	Repasse confirmado	Os recursos de um lote de transações liquidadas foram repassados para a conta bancária do estabelecimento.
Por que isso importa Representa a transferência efetiva dos recursos para a empresa e está relacionado ao 'Tempo do ciclo de conciliação de pagamentos'. Onde encontrar Webhook de notificações do Adyen: eventCode 'PAYOUT_THIRD_PARTY' ou inferência com base no Payout Report. Coleta Associe o ID do lote do Payout Report ao ID da transação Tipo de evento inferred
	Verificação de risco realizada	O mecanismo RevenueProtect do Adyen analisa a transação em busca de sinais de fraude. Esse evento é inferido pela presença de uma pontuação de fraude ou de um resultado de risco na resposta de autorização.
Por que isso importa Pontuações de risco altas podem levar a análises manuais ou recusas automáticas, criando gargalos ou encerrando o processo. Onde encontrar Resposta de pagamento do Adyen (campo fraudResult) ou registros do Case Management. Coleta Inferido pela presença do objeto fraudResult Tipo de evento inferred

Recomendado Opcional

Guias de extração

Como obter seus dados da Adyen

Etapas

Acesse a Customer Area da Adyen com uma conta de usuário que tenha a função Merchant Report.
Acesse Relatórios e selecione Settlement details no menu.
Localize as configurações de Automatic generation ou selecione Generate report para fazer uma exportação única.
No painel de configuração, confirme que o Formato está definido como CSV (valores separados por vírgulas).
Em Include columns, selecione Todos ou marque especificamente: Company Account, Merchant Account, Psp Reference, Merchant Reference, Método de pagamento, Creation Date, TimeZone, Tipo, Modification Reference, Gross Currency, Gross Debit, Gross Credit, Exchange Rate, Net Currency, Net Debit, Net Credit, Commission, Markup, Scheme Fees e Interchange.
IMPORTANTE: confirme que o escopo do relatório inclui todos os Journal Types (Settled, Refunded, Chargeback, PaidOut etc.) para capturar todo o ciclo financeiro.
Gere o relatório para o período desejado (por exemplo, últimos 90 dias). 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 ambiente local de extração.
Execute o script de transformação (fornecido abaixo) para converter o registro CSV 'Wide' em um formato de Event Log 'Long', necessário para o ProcessMind.
O script realiza transformações essenciais: desdobra a coluna Creation Date para criar eventos 'Payment Request Received' e mapeia a coluna Tipo para atividades financeiras específicas.
Verifique se o CSV de saída contém os cabeçalhos: PspReference, EventCode, EventDate, SourceSystem.
Carregue o CSV transformado no ProcessMind.

Configuração

Tipo de relatório: Settlement Detail Report (registro financeiro)
Formato do arquivo: CSV (separação padrão por vírgulas)
Granularidade: nível da transação (uma linha por lançamento financeiro)
Fuso horário: UTC (altamente recomendado para alinhar a extração com outros sistemas)
Período: corresponde aos lotes de liquidação (data de fechamento do lote), não à data de criação da transação. Se a extração for incremental, considere a sobreposição de períodos.
Colunas obrigatórias: Psp Reference (chave), Tipo (atividade), Creation Date, Booking Date (datas e horas dos eventos), Merchant Account.
Configurações de filtro: confirme que nenhum filtro exclui os tipos 'Chargeback' ou 'Refund', para garantir que o processo esteja completo.

a Consulta de exemplo python

import pandas as pd
from datetime import datetime

class=class="hl-string">"hl-comment"># CONFIGURATION
INPUT_FILE = class="hl-string">'settlement_detail_report.csv'
OUTPUT_FILE = class="hl-string">'adyen_event_log.csv'
SOURCE_SYSTEM = class="hl-string">'Adyen'

class=class="hl-string">"hl-comment"># Load the Adyen Settlement Detail Report
class=class="hl-string">"hl-comment"># 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)

class=class="hl-string">"hl-comment"># Define the output list
event_log = []

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

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

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

    class=class="hl-string">"hl-comment"># --- 2. MAPPED FINANCIAL ACTIVITIES ---
    class=class="hl-string">"hl-comment"># Map Adyen Ledger Types to Process Activities using Booking Date
    
    if journal_type == class="hl-string">'Settled':
        add_event(psp_ref, class="hl-string">'Payment Settled', booking_date, row_attrs)
        
        class=class="hl-string">"hl-comment"># Activity: Payment Sent for Settlement
        class=class="hl-string">"hl-comment"># Inferred: Occurs shortly before settlement. 
        class=class="hl-string">"hl-comment"># 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, class="hl-string">'Payment Sent for Settlement', sent_date, row_attrs)

    elif journal_type == class="hl-string">'Refunded':
        add_event(psp_ref, class="hl-string">'Refund Initiated', creation_date, row_attrs)
        add_event(psp_ref, class="hl-string">'Refund Settled', booking_date, row_attrs)

    elif journal_type == class="hl-string">'Chargeback':
        add_event(psp_ref, class="hl-string">'Chargeback Notification Received', booking_date, row_attrs)

    elif journal_type == class="hl-string">'ChargebackRetried':
        add_event(psp_ref, class="hl-string">'Chargeback Defended', booking_date, {class="hl-string">'IsRework': class="hl-string">'True'})

    elif journal_type == class="hl-string">'ChargebackReversed':
        add_event(psp_ref, class="hl-string">'Chargeback Reversed', booking_date, row_attrs)

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

    elif journal_type == class="hl-string">'CaptureFailed':
        add_event(psp_ref, class="hl-string">'Capture Failed', booking_date, {class="hl-string">'IsRework': class="hl-string">'True'})

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

    elif journal_type == class="hl-string">'Error':
        add_event(psp_ref, class="hl-string">'Technical Error Logged', booking_date, {class="hl-string">'IsRework': class="hl-string">'True'})

class=class="hl-string">"hl-comment"># Convert to DataFrame
events_df = pd.DataFrame(event_log)

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

class=class="hl-string">"hl-comment"># Output
events_df.to_csv(OUTPUT_FILE, index=False)
print(fclass="hl-string">'Successfully extracted {len(events_df)} events to {OUTPUT_FILE}')

Etapas

Configuração dos pré-requisitos: confirme se você tem um usuário de relatórios do Adyen com a função Merchant Report habilitada. Obtenha sua API Key na Customer Area, em Developers > API Credentials.
Identificação dos relatórios necessários: esta extração usa dois relatórios CSV importantes gerados pelo Adyen: o Settlement Detail Report (para eventos financeiros, como liquidação, chargebacks e reembolsos) e o Received Payment Detail Report (para eventos operacionais, como solicitações, recusas e autorizações).
Configuração do ambiente Python: instale as bibliotecas necessárias com pip: pandas, requests e numpy. Elas serão usadas na comunicação com a API e na transformação dos dados.
Implementação da conexão com a API: configure o script Python (fornecido abaixo) para autenticar nos endpoints https://management-test.adyen.com ou https://management-live.adyen.com. Use a Report API para listar os relatórios disponíveis no período escolhido e baixar os arquivos pelos URLs correspondentes.
Ingestão dos dados: o script lê os dados brutos do CSV em DataFrames do pandas. Em geral, os relatórios do Adyen têm formato amplo, com uma linha por transação e várias colunas de status, por isso é necessário transformá-los.
Mapeamento de atividades operacionais: processe o Received Payment Detail Report. Mapeie CreationDate para Solicitação de pagamento recebida. Use a coluna Status (por exemplo, Authorised, Refused, Error) para gerar os eventos Pagamento autorizado, Pagamento recusado ou Erro técnico registrado.
Mapeamento de atividades financeiras: processe o Settlement Detail Report, que contém a coluna JournalType. Mapeie valores como Settled para Pagamento liquidado, Refunded para Reembolso iniciado e Chargeback para Notificação de chargeback recebida.
Inferência de atividades complexas:
- Análise de risco realizada: verifique se a coluna FraudScore está preenchida e contém um valor maior que -1.
- Repasse confirmado: vincule as transações à entrada de repasse no relatório de liquidação usando BatchNumber.
- Chargeback contestado: procure os tipos de lançamento SecondChargeback ou Defense.
Transformação dos dados: aplique uma operação 'melt' ou 'stack' no pandas para converter o conjunto de dados de formato amplo em um Event Log longo, com cada atividade em uma linha separada.
Padronização dos atributos: renomeie as colunas para corresponder ao esquema de destino: PspReference, EventCode, EventDate, SourceSystem (com o valor fixo 'Adyen') e PaymentAmount. Converta as datas para o formato ISO 8601.
Filtragem: use o filtro Tipo para remover linhas de conciliação interna que não representam etapas do processo, como linhas de cabeçalho ou saldos transportados.
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 da API: alterne entre os endpoints de teste da Adyen (management-test.adyen.com) e de produção (management-live.adyen.com), conforme a etapa da implantação.
Autenticação: use x-api-key no cabeçalho. Não use Basic Auth na Management API.
Tipos de relatório:
- settlement_detail_report: essencial para eventos do ciclo financeiro.
- received_payment_detail_report: essencial para a lógica da solicitação inicial e da autorização.
Período: os relatórios da Adyen são gerados com base no fechamento do lote. Solicite relatórios que cubram a CreationDate de interesse e mais 7 dias, para capturar liquidações atrasadas.
Escopo da conta de comerciante: se você tiver várias contas de comerciante, percorra a lista de contas ou use o relatório no nível da Company Account, se disponível.
Configuração do pandas: se o volume de transações ultrapassar 100 mil linhas, defina low_memory=False ao ler os arquivos CSV para evitar erros na inferência de tipos.

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.')

Pronto para começar?

Use este Template para simplificar a coleta de dados e começar a otimizar o processamento de pagamentos na Adyen. Identifique oportunidades de eficiência e obtenha insights mais detalhados sobre suas operações financeiras.

Voltar ao guia de melhoria Baixar Template

Simplifique o processamento de pagamentos na Adyen hoje mesmo.

Alcance 98% de processamento direto e elimine exceções de pagamento.

Começar o teste grátis

Não é necessário cartão de crédito. Comece a otimizar agora.

Seu Template de dados de processamento de pagamentos

Seu Template de dados de processamento de pagamentos

Atributos do processamento de pagamentos

Atividades do processamento de pagamentos

Guias de extração

Exportação do relatório detalhado de liquidação da Adyen

Etapas

Configuração

a Consulta de exemplo python

Extração em Python pela Reporting API

Etapas

Configuração

a Consulta de exemplo python

Pronto para começar?

Simplifique o processamento de pagamentos na Adyen hoje mesmo.

Seu Template de dados de processamento de pagamentos

Seu Template de dados de processamento de pagamentos

Atributos do processamento de pagamentos

Atividades do processamento de pagamentos

Guias de extração

Exportação do relatório detalhado de liquidação da Adyen

Etapas

Configuração

a Consulta de exemplo python

Extração em Python pela Reporting API

Etapas

Configuração

a Consulta de exemplo python

Pronto para começar?

Simplifique o processamento de pagamentos na Adyen hoje mesmo.

Sua privacidade é importante para nós