{"section":"tutorials","requestedLocale":"pt","requestedSlug":"configurar-pagamento-com-adyenv3-no-vtex-sales-app","locale":"pt","slug":"configurar-pagamento-com-adyenv3-no-vtex-sales-app","path":"docs/pt/tutorials/pagamentos/configurações-de-pagamentos/configurar-pagamento-com-adyenv3-no-vtex-sales-app.md","branch":"main","content":"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 via **VTEX Sales App**, utilizando pontos de vendas (POS). Para mais informações, acesse [O que é o VTEX Sales App?](https://help.vtex.com/pt/docs/tracks/vtex-sales-app-primeiros-passos-e-configuracoes).\n\n> ℹ️ Para utilizar a afiliação AdyenV3 em sua loja por outros canais de venda online (exceto **VTEX Sales App**), acesse [Configurar pagamento com AdyenV3](https://developers.vtex.com/docs/apps/adyen.payment-provider-v3).\n\nPara utilizar a afiliação AdyenV3 no **VTEX Sales App**, é necessário:\n\n- [Configurar ponto de venda (POS)](#configurar-ponto-de-venda-pos)\n- [Configurar ambiente Adyen](#configurar-ambiente-adyen)\n- [Configurar conector AdyenV3 (VTEX Sales App) na VTEX](#configurar-conector-adyenv3-vtex-sales-app-na-vtex)\n- [Configurar condição de pagamento](#configurar-condicao-de-pagamento)\n\n> ⚠️ 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.\n\n## Configurar ponto de venda (POS)\n\nO 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:\n\n- [Adyen - Terminal API go-live checklist](https://docs.adyen.com/point-of-sale/get-started/go-live-tapi)\n- [VTEX - VTEX Sales App Basic settings](https://help.vtex.com/pt/docs/tutorials/configurar-pagamento-com-adyenv3-no-vtex-sales-app)\n\n## Configurar ambiente Adyen\n\nOs 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](https://docs.adyen.com/).\n\nPara habilitar o acesso da VTEX no ambiente Adyen, siga as instruções abaixo:\n\n### Obtenha as credenciais Company e Merchant Account\n\n1. Acesse a sua [Área do Cliente](https://ca-test.adyen.com/) na Adyen.\n2. Na barra lateral esquerda, copie e salve a informação descrita acima de **Company**. Esta é a sua Company Account.\n3. Na lista abaixo, busque o nome da Merchant Account a ser utilizada (ressaltada em branco). Copie e salve esta informação.\n\n![Adyenv3_1](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/pagamentos/configurações-de-pagamentos/configurar-pagamento-com-adyenv3-no-vtex-sales-app_1.PNG)\n\n### Obtenha a POS Live URL\n\nEsta 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](https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api#cloud).\n\n### Obtenha a Live URL prefix\n\n1. Na barra lateral, acesse **Developers > API URLs**.\n2. 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.\n\n### Obtenha a API Key\n\nAs 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](https://docs.adyen.com/).\n\n1. Clique em **Developers** na barra lateral e em seguida em **API credentials**.\n2. Selecione a sua credencial API.\n3. Em **Server Settings > Authentication**, selecione **API key**.\n\n    ![Adyenv3_2](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/pagamentos/configurações-de-pagamentos/configurar-pagamento-com-adyenv3-no-vtex-sales-app_2.PNG)\n\n4. Clique em **Generate Key** e anote a informação criada em um local seguro.\n\n### Configure o webhook\n\nA configuração do webhook é necessária para que a Adyen envie atualizações de status de pagamento para sua conta na VTEX. Para mais informações, acesse a documentação [Webhooks](https://docs.adyen.com/development-resources/webhooks) da Adyen.\n\nConfigure o webhook conforme os passos abaixo:\n\n1. Na sua [Área do Cliente](https://ca-test.adyen.com/) na Adyen, acesse **Developers > Webhooks**.\n2. Clique no botão azul `+ Webhook`.\n3. Selecione a opção **Standard Webhook** clicando no botão **Add**.\n4. Em **General > Description**, adicione uma descrição para o novo webhook. Exemplo: \"Webhook Adyen Connector Provider v3\".\n5. Em **General > Server configuration > URL**, preencha a URL da sua conta VTEX. Exemplo: https://\\{\\{account\\}\\}.myvtex.com/_v3/api/webhook/notification.\n\n    ![Adyenv3_4](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/pagamentos/configurações-de-pagamentos/configurar-pagamento-com-adyenv3-no-vtex-sales-app_3.PNG)\n\n6. Clique em **Apply**.\n7. Em **Additional settings**, selecione todas as opções disponíveis e clique em **Apply** em cada aba.\n8. Clique em **Save changes**.\n\n![Adyenv3_5](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/pagamentos/configurações-de-pagamentos/configurar-pagamento-com-adyenv3-no-vtex-sales-app_4.PNG)\n\n![Adyenv3_6](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/pagamentos/configurações-de-pagamentos/configurar-pagamento-com-adyenv3-no-vtex-sales-app_5.PNG)\n\n![Adyenv3_7](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/pagamentos/configurações-de-pagamentos/configurar-pagamento-com-adyenv3-no-vtex-sales-app_6.PNG)\n\n> ℹ️ Se você possui múltiplas lojas, é necessário realizar a configuração do webhook para cada uma delas.\n\n## Configurar conector AdyenV3 (VTEX Sales App) na VTEX\n\n1. No Admin VTEX, acesse **Configurações da loja > Pagamentos > Provedores**, ou digite **Provedores** na barra de busca no topo da página.\n2. Na tela de provedores, clique no botão `Novo provedor`.\n3. Digite o nome **AdyenV3** na barra de busca e clique sobre o nome do provedor.\n4. Em **Chave de aplicação**, preencha o nome de sua Merchant account (passo 3 da seção [Obtenha as credenciais Company e Merchant Account](#obtenha-as-credenciais-company-e-merchant-account)).\n5. Em **Token de aplicação**, insira o API Key (passo 4 da seção [Obtenha a API Key](#obtenha-a-api-key)).\n6. 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**.\n7. Em **Controle de pagamento**, selecione se deseja ativar o provedor em ambiente de teste clicando em **Ativar modo de teste**.\n8. Em **Live URL prefix**, preencha o prefixo disponível na customer area da Adyen (passo 2 da seção [Obtenha a Live URL prefix](#obtenha-a-live-url-prefix)).\n9. Em **Company account**, insira o nome de sua company account (passo 2 da seção [Obtenha as credenciais Company e Merchant Account](#obtenha-as-credenciais-company-e-merchant-account)).\n10. Em **Live POS URL**, preencha com endpoints utilizados para acessar as APIs de terminais da Adyen. Saiba mais em [documentação Adyen](https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api#cloud).\n11. O campo **Client Key** não é necessário preencher, pois é aplicável somente a outros tipos de canais de venda online.\n12. Em **Auto Capture Settings**, selecione em que momento deseja realizar a captura do pagamento.\n13. Clique em `Salvar`.\n\n## Configurar condição de pagamento\n\n1. No Admin VTEX, acesse **Configurações da loja > Pagamentos > Configurações**, ou digite **Configurações** na barra de busca no topo da página.\n2. Na aba **Condições de Pagamentos**, clique no botão `+`.\n3. Clique em **Venda Direta Debito** ou **Venda Direta Credito**.\n4. Em **Processar com a afiliação**, selecione o conector configurado anteriormente.\n5. Ative a condição no campo **Status**.\n6. Se desejar utilizar um sistema antifraude, selecione a opção **Usar solução antifraude**.\n7. Se desejar, você também pode [configurar condições especiais de pagamento](/pt/docs/tutorials/condicoes-especiais).\n8. Clique em `Salvar`.\n\nDepois 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."}