> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adyen - Conexão e Acesso à API de Cartão Bruto

> Gere a chave da API, conta de comerciante e webhook assinado com HMAC que você precisa para conectar o Adyen como seu próprio processador com Bring Your Own Processor (BYOP).

<Note>
  Este guia aplica-se quando você conecta o **Adyen** como seu próprio processador através do [Bring Your Own Processor (BYOP)](/features/byop). [Fale conosco](mailto:founders@dodopayments.com) se precisar de ajuda.
</Note>

## Habilitar acesso a dados brutos do cartão

Antes que o Dodo possa direcionar pagamentos por meio do Adyen, sua conta Adyen precisa ter **acesso a dados brutos do cartão** habilitado. Adyen condiciona isso à conformidade com o PCI DSS. Como o **Dodo Payments lida com os dados brutos do cartão em seu nome** e é **compatível com o PCI DSS Nível 1**, você fornece a **Atestação de Conformidade (AOC) do Dodo Payments** ao Adyen — você não precisa da sua própria certificação.

<Card title="Dodo Payments PCI DSS Attestation of Compliance (AOC)" icon="file-shield" href="https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf">
  Baixe o AOC atual do Dodo Payments e envie-o para o suporte do Adyen para habilitar o acesso a dados brutos do cartão.
</Card>

Entre em contato com o suporte do Adyen para solicitar acesso a dados brutos do cartão para sua conta de comerciante, anexando o AOC acima.

## O que você vai precisar

Para conectar o Adyen em **Configurações → BYOP**, reúna três valores da sua Área de Cliente do Adyen:

| Valor                    | De onde vem                                        |
| ------------------------ | -------------------------------------------------- |
| **Chave da API**         | Desenvolvedores → Credenciais da API               |
| **Conta de Comerciante** | Identificador da sua conta de comerciante do Adyen |
| **Chave HMAC**           | Gerada quando você configura o webhook             |

<Info>
  Adyen mantém as credenciais de **teste** (`ca-test.adyen.com`) e **produção** (`ca-live.adyen.com`) separadas. Gere as credenciais no ambiente que corresponda ao modo que você está configurando no Dodo.
</Info>

## Etapa 1: Gerar uma chave de API

<Steps>
  <Step title="Open API credentials">
    Na Área de Cliente do Adyen, vá para **Desenvolvedores → Credenciais da API**. Você precisa do papel **Gerenciar credenciais da API** ou **Administrador do comerciante**.
  </Step>

  <Step title="Select your credential">
    Escolha a aba **Pagamentos** e selecione seu nome de usuário de credencial (parece `ws_123456@Company.YourCompanyAccount`).
  </Step>

  <Step title="Generate the key">
    Vá para **Configurações do servidor → Autenticação**, abra a aba **Chave da API** e selecione **Gerar chave da API**.
  </Step>

  <Step title="Copy it immediately">
    Copie e armazene a chave de forma segura; você não poderá copiá-la novamente após sair da página. Uma chave recém-gerada é ativada imediatamente e a chave anterior continua funcionando por 24 horas.
  </Step>
</Steps>

## Etapa 2: Encontrar sua conta de comerciante

Sua **conta de comerciante** é o identificador de conta que Adyen usa para processar suas transações. Ela é exibida no seletor de contas no topo da Área de Cliente (por exemplo, `YourCompany_ECOM`). Você irá colar isso no campo **Conta de Comerciante** no Dodo.

## Etapa 3: Configurar o webhook e a chave HMAC

Dodo gera uma URL de **Endpoint de Webhook** quando você salva a conexão Adyen. Adicione-a como um webhook no Adyen e gere uma chave HMAC. Você precisa do papel de **Administrador do comerciante** ou **Integrador técnico de comerciante**.

<Steps>
  <Step title="Create a webhook">
    Na Área de Cliente, vá para **Desenvolvedores → Webhooks** e selecione **Criar novo webhook**. Na lista, selecione **Adicionar** para o tipo **Webhook padrão**.
  </Step>

  <Step title="Configure the webhook">
    * Insira uma **Descrição**.
    * Alterne **Ativado** para ativá-lo.
    * Em **Configuração do servidor**, cole a URL do **Endpoint de Webhook** que o Dodo gerou no campo **URL** (deve ser HTTPS e acessível publicamente).
  </Step>

  <Step title="Generate the HMAC key">
    Em **Segurança**, na seção **Chave HMAC**, selecione **Gerar** para criar uma nova chave HMAC. Copie e armazene-a de forma segura; você não poderá copiá-la novamente mais tarde. Em seguida, selecione **Salvar configuração**.
  </Step>

  <Step title="Paste the HMAC key into Dodo">
    De volta em **Configurações → BYOP**, cole a chave HMAC no campo **Segredo de Assinatura do Webhook** para finalizar a conexão.

    <Card title="Set up BYOP" icon="shuffle" href="/features/byop">
      Siga todo o fluxo de configuração do Bring Your Own Processor.
    </Card>
  </Step>
</Steps>

<Tip>
  Depois de salvar, use **Verificar conexão** no Dodo para realizar uma chamada de teste contra o Adyen e confirmar que sua chave da API, conta de comerciante e chave HMAC são válidas antes de ir ao vivo.
</Tip>

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="What is the HMAC key for?">
    Adyen assina cada webhook com uma assinatura HMAC para que o receptor possa verificar a integridade e a origem da notificação. O Dodo usa a chave HMAC que você fornece para validar os webhooks da sua conta Adyen.
  </Accordion>

  <Accordion title="I lost my API key or HMAC key, what now?">
    Nenhuma das duas pode ser recuperada após a criação. Gere uma nova chave da API em **Desenvolvedores → Credenciais da API**, ou uma nova chave HMAC nas configurações do webhook, então atualize o valor em **Configurações → BYOP**.
  </Accordion>

  <Accordion title="Do test and live use the same credentials?">
    Não. Gere credenciais no ambiente correspondente, **teste** (`ca-test.adyen.com`) ou **produção** (`ca-live.adyen.com`), e configure-as no modo correspondente no Dodo.
  </Accordion>
</AccordionGroup>

## Referências

* [Adyen: API credentials](https://docs.adyen.com/development-resources/api-credentials/)
* [Adyen: Configure and manage webhooks](https://docs.adyen.com/development-resources/webhooks/configure-and-manage)