Adyen

Adyen precisa de um verdadeiro trabalho de casa no console do provedor: a maior parte do que Athia ingere chega como arquivos de relatórios programados, portanto, esses relatórios devem existir primeiro. Faça isso e a Adyen se tornará a melhor fonte de liquidação e custo que você pode conectar.

O que você ganha#

Detalhes de liquidação e liquidação agregada, contabilidade de pagamentos, detalhes de pagamentos recebidos, detalhes de taxas de intercâmbio e esquema, detalhes de transações de disputa e resultados de autenticação 3D Secure.

Mais forte para liquidação e detalhes de taxas. A Adyen detalha o que foi acertado e o custo em um nível que a maioria dos fornecedores não expõe, tornando-se a fonte de referência para o custo por pedido aprovado.

Mais fraco para contexto de assinatura, que é tênue aqui – essa imagem vem de outro lugar.

Antes de começar#

1. Habilite e agende os relatórios. Selecione a conta do comerciante no menu suspenso superior esquerdo → Relatórios na navegação esquerda → pesquise e configure cada relatório → clique Gerar → selecione Automatizado (gerar dentro do cronograma) → escolher .CSV como o Tipo de arquivo. Configure tudo isso:

• Autenticação 3D Segura
• Autenticação 3DS
• Detalhes agregados de liquidação
• Detalhes da transação de disputa
• Taxa de intercâmbio e esquema
• Contabilidade de pagamentos
• Detalhes do pagamento recebido
• Detalhes da liquidação

Automatize esses relatórios no conta da empresa nível, bem como por conta de comerciante - o agendamento por conta de comerciante por si só não produz relatórios em nível de empresa.

Após a primeira conta de comerciante, marque os relatórios com estrela (marque como favorito) para que o restante seja mais rápido.

2. Crie o usuário do serviço Relatório. Mudar para visão em nível de empresa, crie a credencial e selecione Usuário do serviço de relatório como o Tipo de credencial. Copie o Nome de usuário de Configurações gerais, em seguida, gere o Senha sob Configurações do servidor → Autenticação básica. Associe a credencial ao conta da empresa e cada conta de comerciante você quer em Athia; uma credencial com escopo para uma conta deixa silenciosamente as outras de fora.

3. Crie a credencial da API do serviço Web. Na área do cliente Adyen em nível da empresa, vá para Desenvolvedores → Credenciais de API e crie uma credencial de serviço da web e, em seguida, gere e copie seu Chave de API.

4. Dê à credencial da API de serviço da Web suas funções. Criá-lo não é suficiente. Abaixo Permissões → Funções, conceder Management API - Accounts read e Management API - Webhooks read and write. Abaixo Contas, associe-o ao conta da empresa e todas as contas de comerciante associadas.

Credenciais que Athia pede#

Configurando a conexão#

1. Em Configurações → Conexões, escolha + Adicionar conexão e selecione Adyen.
2. Ativado Configurar conector, insira um Nome e escolha um Cronograma.
3. Ativado Insira as credenciais, cole o Chave de API do serviço Web e o Chave de API do serviço de relatório.
4. Escolha Verifique a conexão.

A conexão então aparece como ACTIVE e a primeira sincronização começa.

Para MIDs adicionais, reutilize as mesmas credenciais — nenhuma alteração adicional na Adyen será necessária se os relatórios já estiverem configurados para esses MIDs.

Registre o webhook Athia no Adyen#

Copie o URL de destino do Webhook de Athia no assistente de conexão e depois no Adyen:

1. Acessar Desenvolvedores → Webhooks → Criar novo webhook → Notificação padrão → Adicionar.
2. Abra Editar configuração do servidor e cole o URL de destino do Webhook de Athia.
3. Abaixo Contas de comerciante, selecione os MIDs — eles devem corresponder aos MIDs para os quais você configurou os relatórios.
4. Abaixo Configurações adicionais, habilitar 3D Secure (inclui resultado e versão 3D Secure), Adquirente (adicionar resultado e referência do adquirente) e Cartão (inclui o BIN do cartão e informações detalhadas do BIN do cartão).
5. Teste o webhook, salve-o e ative-o.

Os eventos de relatório no nível da empresa ainda exigem a solicitação de suporte da Adyen no topo desta página.

Cadência de sincronização#

Seu Cronograma controla a frequência com que Athia procura novos arquivos de relatório, e não a rapidez com que Adyen os produz. Os dados de liquidação avançam apenas quando a Adyen fecha um lote.

Limites e coisas para saber#

• Dependente de relatório. Se um relatório não estiver habilitado no Adyen — ou estiver definido como manual — esses dados nunca chegarão ao Athia e a verificação poderá ser bem-sucedida enquanto o domínio permanecer vazio.
• Os valores são decimais – nunca divida por 100, ao contrário do Stripe.
• Os dados do cartão são minimizados. Para saber o que cada campo ingerido contém, consulte Dicionário de dados Athia.
• O alcance histórico é limitado por quantos relatórios a Adyen retorna, então períodos muito antigos podem ser inacessíveis e devem ser regenerados primeiro na Adyen - na Área do Cliente, vá para Relatórios → selecione relatório → intervalo de datas personalizado. Confirme o lookback alcançável antes de prometer uma janela de preenchimento.

Solução de problemas#

Relacionado#

• Conectores Athia — o catálogo completo de conectores.
• Integrando Athia — caminhos de integração, incluindo descarte de arquivos e depósito para depósito.
• Dicionário de dados Athia — definições em nível de campo.