> ## 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 - Accesso API Connect & Raw Card

> Genera la chiave API, l'account commerciante e il webhook firmato HMAC necessari per connettere Adyen come tuo processore con Bring Your Own Processor (BYOP).

<Note>
  Questa guida è applicabile quando si connette **Adyen** come proprio processore tramite [Bring Your Own Processor (BYOP)](/features/byop). [Contattaci](mailto:founders@dodopayments.com) se hai bisogno di aiuto.
</Note>

## Abilita l'accesso ai dati grezzi delle carte

Prima che Dodo possa instradare i pagamenti tramite Adyen, il tuo account Adyen deve avere **l'accesso ai dati grezzi delle carte** abilitato. Adyen lo consente dietro conformità PCI DSS. Poiché **Dodo Payments gestisce i dati grezzi delle carte per conto tuo** ed è **conforme a PCI DSS Livello 1**, fornisci **l'Attestato di Conformità (AOC) di Dodo Payments** ad Adyen — non hai bisogno della tua certificazione.

<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">
  Scarica l'attuale AOC di Dodo Payments e invialo al supporto di Adyen per abilitare l'accesso ai dati grezzi delle carte.
</Card>

Contatta il supporto di Adyen per richiedere l'accesso ai dati delle carte per il tuo account commerciante, allegando l'AOC sopra.

## Cosa ti servirà

Per connettere Adyen in **Impostazioni → BYOP**, raccogli tre valori dal tuo Area Clienti Adyen:

| Valore                   | Da dove proviene                                  |
| ------------------------ | ------------------------------------------------- |
| **Chiave API**           | Sviluppatori → Credenziali API                    |
| **Account Commerciante** | Identificatore del tuo account commerciante Adyen |
| **Chiave HMAC**          | Generata durante la configurazione del webhook    |

<Info>
  Adyen mantiene separate le credenziali **test** (`ca-test.adyen.com`) e **live** (`ca-live.adyen.com`). Genera le credenziali nell'ambiente che corrisponde alla modalità che stai configurando in Dodo.
</Info>

## Passo 1: Genera una chiave API

<Steps>
  <Step title="Open API credentials">
    Nell'Area Clienti Adyen, vai a **Sviluppatori → Credenziali API**. Hai bisogno del ruolo **Gestisci credenziali API** o **Amministratore commerciante**.
  </Step>

  <Step title="Select your credential">
    Scegli la scheda **Pagamenti** e seleziona il nome utente delle tue credenziali (sembra `ws_123456@Company.YourCompanyAccount`).
  </Step>

  <Step title="Generate the key">
    Vai a **Impostazioni server → Autenticazione**, apri la scheda **Chiave API** e seleziona **Genera chiave API**.
  </Step>

  <Step title="Copy it immediately">
    Copia e conserva la chiave in modo sicuro; non potrai copiarla di nuovo dopo aver lasciato la pagina. Una chiave appena generata è attiva immediatamente, e la chiave precedente continua a funzionare per 24 ore.
  </Step>
</Steps>

## Passo 2: Trova il tuo account commerciante

Il tuo **account commerciante** è l'identificatore che Adyen utilizza per elaborare le tue transazioni. È mostrato nel selettore account in cima all'Area Clienti (per esempio, `YourCompany_ECOM`). Incollerai questo nel campo **Account Commerciante** in Dodo.

## Passo 3: Configura il webhook e la chiave HMAC

Dodo genera un'URL **Endpoint Webhook** quando salvi la connessione Adyen. Aggiungilo come webhook in Adyen e genera una chiave HMAC. Hai bisogno del ruolo **Amministratore commerciante** o **Integratore tecnico commerciante**.

<Steps>
  <Step title="Create a webhook">
    Nell'Area Clienti, vai su **Sviluppatori → Webhook** e seleziona **Crea nuovo webhook**. Dalla lista, seleziona **Aggiungi** per il tipo **Webhook standard**.
  </Step>

  <Step title="Configure the webhook">
    * Inserisci una **Descrizione**.
    * Attiva **Attivato** per attivarlo.
    * Sotto **Configurazione server**, incolla l'URL **Endpoint Webhook** che Dodo ha generato nel campo **URL** (deve essere HTTPS e accessibile pubblicamente).
  </Step>

  <Step title="Generate the HMAC key">
    Sotto **Sicurezza**, nella sezione **Chiave HMAC**, seleziona **Genera** per creare una nuova chiave HMAC. Copiala e conservala in modo sicuro; non potrai copiarla di nuovo in seguito. Poi seleziona **Salva configurazione**.
  </Step>

  <Step title="Paste the HMAC key into Dodo">
    Torna su **Impostazioni → BYOP**, incolla la chiave HMAC nel campo **Segreto di Firma Webhook** per completare la connessione.

    <Card title="Set up BYOP" icon="shuffle" href="/features/byop">
      Segui il flusso completo di configurazione di Bring Your Own Processor.
    </Card>
  </Step>
</Steps>

<Tip>
  Dopo aver salvato, utilizza **Verifica connessione** in Dodo per eseguire una chiamata di prova contro Adyen e confermare che la tua chiave API, l'account commerciante e la chiave HMAC siano validi prima di andare in produzione.
</Tip>

## Domande frequenti

<AccordionGroup>
  <Accordion title="What is the HMAC key for?">
    Adyen firma ogni webhook con una firma HMAC così il ricevente può verificare l'integrità e l'origine della notifica. Dodo utilizza la chiave HMAC che fornisci per validare i webhook dal tuo account Adyen.
  </Accordion>

  <Accordion title="I lost my API key or HMAC key, what now?">
    Nessuno dei due può essere recuperato dopo la creazione. Genera una nuova chiave API sotto **Sviluppatori → Credenziali API**, o una nuova chiave HMAC nelle impostazioni del webhook, poi aggiorna il valore in **Impostazioni → BYOP**.
  </Accordion>

  <Accordion title="Do test and live use the same credentials?">
    No. Genera le credenziali nell'ambiente corrispondente, test (`ca-test.adyen.com`) o live (`ca-live.adyen.com`), e configurale nella modalità corrispondente in Dodo.
  </Accordion>
</AccordionGroup>

## Riferimenti

* [Adyen: credenziali API](https://docs.adyen.com/development-resources/api-credentials/)
* [Adyen: Configurare e gestire i webhook](https://docs.adyen.com/development-resources/webhooks/configure-and-manage)