Skip to main content
Questa guida prepara il tuo account Stripe per Bring Your Own Processor (BYOP): richiedi a Stripe l’accesso all’API dei dati grezzi delle carte, quindi recuperi la chiave segreta e il webhook signing secret necessari a Dodo Payments. Se hai bisogno di aiuto, contattaci.

Abilitare l’accesso ai dati grezzi delle carte

Per instradare i pagamenti attraverso il tuo account Stripe, Dodo Payments invia a Stripe i dati della carta per tuo conto tramite le raw card data APIs di Stripe. Per impostazione predefinita, un account Stripe non può inviare numeri di carta grezzi (PAN) alle proprie API. Stripe abilita questo accesso solo dopo aver verificato che i sistemi che gestiscono i dati grezzi delle carte siano conformi allo standard PCI DSS. Con BYOP, il sistema che gestisce i dati della carta è Dodo Payments, conforme al PCI DSS Level 1, quindi dimostri la conformità tramite la certificazione di Dodo Payments anziché tramite la tua. Devi richiedere questo accesso una sola volta per account. Quando richiedi l’accesso, Stripe chiede una breve descrizione di come vengono gestiti i dati delle carte. Specifica che Dodo Payments, il tuo payment provider conforme a PCI DSS Level 1, elabora i dati grezzi delle carte e che i tuoi sistemi non memorizzano né gestiscono mai i numeri grezzi delle carte. Poiché deleghi completamente la gestione delle carte a Dodo Payments, non hai bisogno di un tuo SAQ D se rientri nei requisiti per SAQ A. Invia il tuo SAQ A, indicando Dodo Payments come third-party service provider nella Parte 2f, e includi il Dodo Payments Attestation of Compliance (AOC) come prova di supporto:

Dodo Payments PCI DSS Attestation of Compliance (AOC)

Scarica la AOC aggiornata di Dodo Payments e inviala a Stripe quando richiedi l’accesso ai dati grezzi delle carte.
La modalità di test non richiede documentazione. Se ti servono le API per i dati grezzi delle carte solo per i test e non puoi utilizzare le carte di test pre-tokenizzate di Stripe, chiedi al supporto Stripe di abilitarle, così potrai creare e verificare la configurazione BYOP. La modalità live richiede comunque il tuo SAQ A e il Dodo Payments AOC.
Per richiedere l’accesso, segui la guida di Stripe e invia il Dodo Payments AOC quando Stripe richiede la documentazione PCI:

Enabling access to raw card data APIs

Guida di Stripe per richiedere l’accesso alle API dei dati grezzi delle carte sul tuo account.

Cosa ti serve

Dopo che Stripe ha confermato l’accesso ai dati grezzi delle carte, collega Stripe in Settings → BYOP. Ti servono due valori dal tuo Stripe Dashboard:
Stripe mantiene separate le credenziali della sandbox (test) e della modalità live. Usa una sandbox Stripe per la modalità di test di Dodo Payments e la modalità live di Stripe per la modalità live di Dodo Payments.

Passaggio 1: ottieni la Secret key

1

Open API Keys

Nel Stripe Dashboard, apri la pagina API keys. Passa dalla modalità sandbox alla modalità live e viceversa per usare la stessa modalità di Dodo Payments che stai configurando.
2

Copy Your Secret Key

Copia la Secret key. Inizia con sk_test_ in una sandbox e con sk_live_ nella modalità live. Usa una secret key standard: le chiavi con restrizioni (rk_...) non sono supportate. Nella modalità live, Stripe mostra una secret key che puoi creare una sola volta, quindi copiala prima di chiudere la finestra di dialogo.Incolla la chiave nel campo Secret Key in Dodo Payments.

Passaggio 2: configura il webhook e la signing secret

Quando salvi la connessione Stripe, Dodo Payments genera un URL Webhook Endpoint. Aggiungilo a Stripe come endpoint webhook, quindi copia la signing secret dell’endpoint.
1

Create an Event Destination

Nel Stripe Dashboard, apri la scheda Webhooks in Workbench e seleziona Create an event destination. Seleziona Your account, quindi seleziona tutti gli eventi. Dodo Payments ha bisogno che l’endpoint riceva ogni tipo di evento.
2

Add the Endpoint URL

Scegli Webhook endpoint come tipo di destinazione. In Endpoint URL, incolla l’URL Webhook Endpoint generato da Dodo Payments. Stripe accetta solo URL HTTPS pubblicamente accessibili.
3

Reveal the Signing Secret

Nella pagina delle impostazioni dell’endpoint, seleziona Reveal secret per visualizzare la Signing secret. Inizia con whsec_. Ogni endpoint ha una secret propria, quindi gli endpoint sandbox e live hanno secret diverse.
4

Paste the Signing Secret into Dodo

In Settings → BYOP, incolla la signing secret nel campo Webhook Signing Secret, quindi seleziona Save & continue per completare la connessione.

Set up BYOP

Segui il flusso completo di configurazione Bring Your Own Processor.
Finché non salvi la signing secret, la connessione Stripe viene visualizzata come Incomplete in Edit Configuration, alla voce Settings → BYOP. Dopo averla salvata, la connessione viene visualizzata come Connected.

Domande frequenti

No, se rientri nei requisiti per SAQ A. Dodo Payments gestisce i dati grezzi delle carte per tuo conto ed è conforme a PCI DSS Level 1, quindi invii il tuo SAQ A indicando Dodo Payments nella Parte 2f, insieme al Dodo Payments Attestation of Compliance (AOC), invece di completare SAQ D o un audit separato.
L’invio di numeri grezzi delle carte a un’API fa rientrare il sistema di invio nell’ambito PCI DSS. Stripe richiede una prova di conformità PCI prima di abilitare le API per i dati grezzi delle carte, in modo da garantire la protezione dei dati dei titolari delle carte. Dodo Payments è conforme a PCI DSS Level 1, quindi fornisci il Dodo Payments AOC come prova.
Sì. Chiedi a Stripe di abilitare le API per i dati grezzi delle carte in modalità di test, che non richiede documentazione PCI, e collega Stripe in modalità di test in Dodo Payments. Prima di elaborare pagamenti reali, devi ottenere l’approvazione per la modalità live.
Per visualizzare nuovamente la signing secret, apri l’endpoint webhook in Stripe e seleziona Reveal secret. Per aggiornarla in Dodo Payments, apri Settings → BYOP, seleziona Edit Configuration, modifica la connessione Stripe, incolla la secret nel campo Webhook Signing Secret e seleziona Save & continue.Se perdi una secret key live che hai creato, Stripe non può mostrarla nuovamente, quindi ruotala o crea una nuova chiave nella pagina API keys. La dashboard Dodo non consente di modificare una secret key salvata. Per sostituire la secret key in una connessione esistente, contatta support@dodopayments.com.

Riferimenti

Ultima modifica il 28 settembre 2026