Questa guida è applicabile quando si connette Adyen come proprio processore tramite Bring Your Own Processor (BYOP). Contattaci se hai bisogno di aiuto.
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.Dodo Payments PCI DSS Attestation of Compliance (AOC)
Scarica l’attuale AOC di Dodo Payments e invialo al supporto di Adyen per abilitare l’accesso ai dati grezzi delle carte.
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 |
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.Passo 1: Genera una chiave API
Open API credentials
Nell’Area Clienti Adyen, vai a Sviluppatori → Credenziali API. Hai bisogno del ruolo Gestisci credenziali API o Amministratore commerciante.
Select your credential
Scegli la scheda Pagamenti e seleziona il nome utente delle tue credenziali (sembra
ws_123456@Company.YourCompanyAccount).Generate the key
Vai a Impostazioni server → Autenticazione, apri la scheda Chiave API e seleziona Genera chiave API.
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.Create a webhook
Nell’Area Clienti, vai su Sviluppatori → Webhook e seleziona Crea nuovo webhook. Dalla lista, seleziona Aggiungi per il tipo Webhook standard.
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).
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.
Domande frequenti
What is the HMAC key for?
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.
I lost my API key or HMAC key, what now?
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.
Do test and live use the same credentials?
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.