Na VTEX, é possível realizar a integração com o provedor de pagamento Adyen. Por meio deste conector, sua loja pode oferecer transações de pagamento em lojas físicas (VTEX Sales App), utilizando pontos de vendas (POS). Para mais informações, acesse O que é o VTEX Sales App?.

Para utilizar a afiliação AdyenV3 em sua loja por outros canais de venda online (exceto VTEX Sales App), acesse Configurar pagamento com AdyenV3.

Para utilizar a afiliação AdyenV3 no VTEX Sales App, é necessário:

• Configurar ponto de venda (POS)
• Configurar ambiente Adyen
• Configurar conector AdyenV3 (VTEX Sales App) na VTEX
• Configurar condição de pagamento

As configurações realizadas em um ambiente externo à VTEX podem ser descontinuadas ou modificadas sem aviso prévio. Consulte sua conta na Adyen para informações atualizadas.

O primeiro passo consiste em configurar suas contas na Adyen e na VTEX para permitir transações de pagamento em pontos de venda (POS). Para realizar estas configurações, acesse as seguintes documentações:

• Adyen - Terminal API go-live checklist
• VTEX - VTEX Sales App Basic settings

Os passos a seguir descrevem as configurações mínimas a serem realizadas para que o conector da Adyen seja devidamente configurado. Demais configurações personalizadas aplicadas à clientes, habilitação de métodos de pagamento específicos ou funcionalidades particulares da plataforma, devem ser realizadas conforme documentação da Adyen.

Para habilitar o acesso da VTEX no ambiente Adyen, siga as instruções abaixo:

1. Acesse a sua Área do Cliente na Adyen.
2. Na barra lateral esquerda, copie e salve a informação descrita acima de Company. Esta é a sua Company Account.
3. Na lista abaixo, busque o nome da Merchant Account a ser utilizada (ressaltada em branco). Copie e salve esta informação.

Esta informação refere-se aos endpoints utilizados pelas APIs de terminais da Adyen em ambiente produtivo. Para mais informações, acesse a documentação Adyen.

1. Na barra lateral, acesse Developers > API URLs.
2. Clique em Copy no campo Prefix e anote a informação salva em um local seguro. Este prefixo controla o seu endpoint na plataforma da Adyen.

As informações abaixo consideram que a API Key já foi previamente gerada no ambiente da Adyen. Caso seja necessário criá-la, consulte a documentação da Adyen.

1. Clique em Developers na barra lateral e em seguida em API credentials.
2. Selecione a sua credencial API.
3. Em Server Settings > Authentication, selecione API key.

A configuração do webhook é necessária para que a Adyen envie atualizações de status de pagamento para sua conta VTEX. Para mais informações, acesse a documentação Webhooks da Adyen.

Configure o webhook conforme os passos abaixo:

1. Na sua Área do Cliente na Adyen, acesse Developers > Webhooks.
2. Clique no botão azul + Webhook.
3. Selecione a opção Standard Webhook clicando no botão Add.
4. Em General > Description, adicione uma descrição para o novo webhook. Exemplo: "Webhook Adyen Connector Provider v3".
5. Em General > Server configuration > URL, preencha a URL da sua conta VTEX. Exemplo: https://{{account}}.myvtex.com/_v3/api/webhook/notification.

Se você possui múltiplas lojas, é necessário realizar a configuração do webhook para cada uma delas.

1. No Admin VTEX, acesse Configurações da loja > Pagamentos > Provedores, ou digite Provedores na barra de busca no topo da página.
2. Na tela de provedores, clique no botão Novo provedor.
3. Digite o nome AdyenV3 na barra de busca e clique sobre o nome do provedor.
4. Em Chave de aplicação, preencha o nome de sua Merchant account (passo 3 da seção Obtenha as credenciais Company e Merchant Account.
5. Em Token de aplicação, insira o API Key (passo 4 da seção Obtenha a API Key).
6. Caso deseje modificar o nome de identificação a ser exibido para o provedor AdyenV3 na tela do Admin VTEX, insira a informação no campo Nome em Informações básicas.
7. Em Controle de pagamento, selecione se deseja ativar o provedor em ambiente de teste clicando em Ativar modo de teste.
8. Em Live URL prefix, preencha o prefixo disponível na customer area da Adyen (passo 2 da seção Obtenha a Live URL prefix).
9. Em Company account, insira o nome de sua company account (passo 2 da seção Obtenha as credenciais Company e Merchant Account).
10. Em Live POS URL, preencha com endpoints utilizados para acessar as APIs de terminais da Adyen. Saiba mais em documentação Adyen.
11. O campo Client Key não é necessário preencher, pois é aplicável somente a outros tipos de canais de venda online.
12. Em Auto Capture Settings, selecione em que momento deseja realizar a captura do pagamento.
13. Clique em Salvar.

1. No Admin VTEX, acesse Configurações da loja > Pagamentos > Configurações, ou digite Configurações na barra de busca no topo da página.
2. Na aba Condições de Pagamentos, clique no botão +.
3. Clique em Venda Direta Debito ou Venda Direta Credito.
4. Em Processar com a afiliação, selecione o conector configurado anteriormente.
5. Ative a condição no campo Status.
6. Se desejar utilizar um sistema antifraude, selecione a opção Usar solução antifraude.
7. Se desejar, você também pode configurar condições especiais de pagamento.
8. Clique em Salvar.

Depois de seguir os passos indicados, o conector AdyenV3 pode demorar até 10 minutos para aparecer como opção de pagamento no VTEX Sales App de sua loja.