European Payment Methods - Dodo Payments Documentation

European customers strongly prefer local payment methods that integrate with their banking systems. Offering these methods can increase conversion rates by 20-40% in target markets.

Why Local European Payment Methods?

Higher Conversion

iDEAL captures ~60% of Dutch online payments. Not offering it means losing customers.

Lower Fraud

Bank-authenticated payments have near-zero fraud rates and no chargebacks.

Real-Time Settlement

Most European methods provide instant payment confirmation.

Supported Methods

Metodo	Paese	Quota di mercato	Valuta	Abbonamenti
iDEAL	Paesi Bassi	~60%	EUR	No
Bancontact	Belgio	~50%	EUR	No
EPS	Austria	~30%	EUR	No
Multibanco	Portogallo	~40%	EUR	No
BLIK	Polonia	~60%	PLN	No
SEPA Direct Debit	Eurozona	Ampiamente utilizzato	EUR	No
Satispay	Europa (Italia)	In crescita	EUR	Sì

iDEAL (Netherlands)

iDEAL is the dominant online payment method in the Netherlands, connecting directly to all major Dutch banks.

How It Works

Supported Banks

All major Dutch banks are supported:

ABN AMRO
ASN Bank
Bunq
ING
Knab
Rabobank
RegioBank
Revolut
SNS
Triodos Bank
Van Lanschot

Configuration

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['ideal', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'NL',
    zipcode: '1012JS'
  },
  return_url: 'https://example.com/success'
});

Bancontact (Belgium)

Bancontact is Belgium’s national payment scheme, used by virtually all Belgian banks for online payments.

Features

Works with existing Belgian debit cards
Mobile app support (Payconiq by Bancontact)
Instant payment confirmation
No additional registration needed for customers

Configuration

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['bancontact_card', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'BE',
    zipcode: '1000'
  },
  return_url: 'https://example.com/success'
});

EPS (Austria)

EPS (Electronic Payment Standard) enables direct online bank transfers for Austrian customers.

Features

Direct integration with Austrian banks
Real-time payment confirmation
High trust among Austrian consumers
No chargebacks

Supported Banks

Major Austrian banks including:

Erste Bank
Bank Austria
Raiffeisen
BAWAG
Volksbank

Configuration

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['eps', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'AT',
    zipcode: '1010'
  },
  return_url: 'https://example.com/success'
});

Multibanco (Portugal)

Multibanco is Portugal’s interbank network, offering both online payments and ATM-based payments.

Payment Options

Online Banking — Direct bank transfer via internet banking
ATM Payment — Customer receives a reference to pay at any Multibanco ATM
Mobile Banking — Payment via bank mobile apps

How ATM Payment Works

For ATM payments, customers receive a payment reference:

Entity: 12345
Reference: 123 456 789
Amount: €50.00
Expiry: 24 hours

Customer can pay at any Portuguese ATM or via online banking using this reference.

Configuration

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['multibanco', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'PT',
    zipcode: '1000-001'
  },
  return_url: 'https://example.com/success'
});

Multibanco ATM payments may have a delay between checkout and actual payment. Monitor webhooks for payment confirmation.

BLIK (Polonia)

BLIK è il metodo di pagamento mobile più popolare in Polonia e consente ai clienti di pagare utilizzando un codice monouso di 6 cifre generato nell’app della propria banca. BLIK effettua il settlement in PLN (złoty polacco), non in EUR.

How It Works

Availability

Valuta di addebito: solo PLN
Tipo di transazione: solo pagamenti una tantum (non disponibile per gli abbonamenti)
Copertura: tutte le principali banche polacche che supportano BLIK

Configuration

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['blik', 'credit', 'debit'],
  billing_currency: 'PLN',
  billing_address: {
    country: 'PL',
    zipcode: '00-001'
  },
  return_url: 'https://example.com/success'
});

BLIK richiede una valuta di addebito in PLN. Se indichi i prezzi in EUR, abilita Adaptive Currency in modo che ai clienti polacchi venga addebitato l’importo in PLN e BLIK diventi disponibile.

SEPA Direct Debit (Eurozona)

SEPA Direct Debit consente ai clienti in tutta l’Eurozona di pagare direttamente dal proprio conto bancario invece di utilizzare una carta. È disponibile nei checkout in EUR per i pagamenti una tantum.

SEPA Direct Debit non è istantaneo: un pagamento richiede fino a 6 giorni lavorativi per essere confermato. A differenza di tutti gli altri metodi presenti in questa pagina, il fatto che il cliente autorizzi l’addebito al checkout non significa che il denaro sia stato accreditato. Non completare mai l’ordine al reindirizzamento del checkout o su payment.processing; attendi il webhook payment.succeeded.

Come funziona

Il cliente autorizza l’addebito durante il checkout, quindi Dodo Payments riscuote i fondi dal suo conto bancario. Poiché la banca esegue il regolamento dell’addebito in modo asincrono, il pagamento passa attraverso uno stato processing prima di raggiungere un esito definitivo:

Cronologia del pagamento

Fase	Quando	Stato del pagamento	Significato
Autorizzazione	Al checkout	`processing`	Il cliente ha approvato l’addebito ed è stato reindirizzato indietro. Il denaro non è ancora stato trasferito: non completare l’ordine.
Conferma	Fino a 6 giorni lavorativi dopo	`succeeded`	La banca ha regolato l’addebito. Ora puoi completare l’ordine.
Fallimento	Fino a 6 giorni lavorativi dopo	`failed`	Non è stato possibile riscuotere l’addebito (ad esempio, per fondi insufficienti). Non completare l’ordine; informa il cliente.

Poiché la conferma arriva giorni dopo che il cliente ha lasciato il tuo sito, deve essere il tuo gestore dei webhook — non il reindirizzamento del checkout — a concedere l’accesso. Consulta Gestione del ritardo nella conferma qui sotto.

Disponibilità

Valuta di fatturazione: EUR
Tipo di transazione: Solo pagamenti una tantum (non disponibile per gli abbonamenti)

Configurazione

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['sepa', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'DE',
    zipcode: '10115'
  },
  return_url: 'https://example.com/success'
});

IBAN SEPA di test

In modalità di test, inserisci uno degli IBAN riportati di seguito al checkout per forzare un esito specifico.

IBAN di test	Comportamento
`DE89370400440532013000`	Il pagamento va a buon fine.
`DE08370400440532013003`	Il pagamento va a buon fine dopo un ritardo di almeno tre minuti.
`DE62370400440532013001`	Il pagamento non va a buon fine.
`DE78370400440532013004`	Il pagamento non va a buon fine dopo un ritardo di almeno tre minuti.
`DE35370400440532013002`	Il pagamento va a buon fine, poi viene contestato immediatamente.
`DE65370400440002222227`	Il pagamento non va a buon fine a causa di fondi insufficienti.
`DE18370400440000066666`	Il conto bancario non è utilizzabile, quindi non è possibile creare il metodo di pagamento.

Per testare il comportamento specifico per paese, usa l’IBAN equivalente per un altro paese della zona euro:

Paese	IBAN di successo
Austria	`AT611904300234573201`
Belgio	`BE62510007547061`
Estonia	`EE382200221020145685`
Finlandia	`FI2112345600000785`
Francia	`FR1420041010050500013M02606`
Irlanda	`IE29AIBK93115212345678`
Lussemburgo	`LU280019400644750000`

Gli IBAN di test con ritardo sono utili per verificare che sia il gestore dei webhook — anziché il reindirizzamento del checkout — a concedere l’accesso, poiché i pagamenti SEPA vengono confermati molto tempo dopo che il cliente ha lasciato il checkout.

Gestione del ritardo nella conferma

Poiché il regolamento SEPA richiede fino a 6 giorni lavorativi dopo il checkout, non puoi affidarti al reindirizzamento del browser per sapere se un pagamento è stato accreditato. Gestisci invece l’evasione tramite gli eventi webhook. Attiva payload.type e gestisci ogni fase:

Tipo di evento	Quando viene generato	Azione
`payment.processing`	Il cliente ha autorizzato l’addebito al checkout ed è stato reindirizzato indietro.	Non completare l’ordine. Contrassegna l’ordine come in sospeso e, facoltativamente, informa il cliente che il pagamento è in elaborazione.
`payment.succeeded`	La banca ha regolato l’addebito (fino a 6 giorni lavorativi dopo).	Completa l’ordine: concedi l’accesso, configura il prodotto e invia la ricevuta.
`payment.failed`	Non è stato possibile riscuotere l’addebito.	Informa il cliente e chiedigli di riprovare; non completare l’ordine.

Handling SEPA payment events

app.post('/webhooks/dodo', async (req, res) => {
  const event = req.body;

  switch (event.type) {
    case 'payment.processing': {
      // SEPA debit authorized but NOT settled — this can last up to 6 business days.
      // Record the order as pending; do not grant access yet.
      await markOrderPending(event.data.payment_id);
      break;
    }
    case 'payment.succeeded': {
      // The debit cleared — safe to fulfill now.
      await fulfillOrder(event.data.payment_id);
      break;
    }
    case 'payment.failed': {
      // The debit could not be collected (e.g. insufficient funds).
      await markOrderFailed(event.data.payment_id);
      // Notify the customer and prompt a retry.
      break;
    }
  }

  res.json({ received: true });
});

Completa sempre l’ordine tramite payment.succeeded dal webhook, mai tramite il reindirizzamento del checkout o payment.processing. Il reindirizzamento viene attivato nel momento in cui il cliente autorizza l’addebito, giorni prima che il denaro venga effettivamente accreditato. Verifica la firma del webhook prima di elaborarlo; consulta la guida ai webhook per la configurazione e la guida agli eventi webhook per l’elenco completo degli eventi.

Definisci le aspettative del cliente al checkout. Poiché l’accesso viene concesso solo dopo l’accredito dell’addebito, informa i clienti SEPA che il loro ordine è in elaborazione e che riceveranno una notifica una volta confermato il pagamento; altrimenti potrebbero aspettarsi un accesso istantaneo come per un pagamento con carta.

Satispay (Europa)

Satispay è una rete europea di pagamenti mobili molto diffusa, soprattutto in Italia, che consente ai clienti di pagare direttamente dalla propria app Satispay senza condividere i dati della carta o del conto bancario. Satispay esegue il regolamento in EUR.

Funzionalità

Pagamenti basati sull’app e indipendenti dai circuiti delle carte
Ampia diffusione in Italia e crescita negli altri mercati europei
Supporta sia i pagamenti una tantum sia gli abbonamenti

Disponibilità

Valuta di fatturazione: EUR
Tipo di transazione: Pagamenti una tantum e abbonamenti

Configurazione

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['satispay', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'IT',
    zipcode: '00100'
  },
  return_url: 'https://example.com/success'
});

Tipi di metodo API

Tipo	Metodo	Paese
`ideal`	iDEAL	Paesi Bassi
`bancontact_card`	Bancontact	Belgio
`eps`	EPS	Austria
`multibanco`	Multibanco	Portogallo
`blik`	BLIK	Polonia
`sepa`	SEPA Direct Debit	Zona euro
`satispay`	Satispay	Europa (Italia)

Checkout europeo multi-paese

Per le aziende che servono più paesi europei, includi tutti i metodi regionali:

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: [
    'ideal',           // Netherlands
    'bancontact_card', // Belgium
    'eps',             // Austria
    'multibanco',      // Portugal
    'blik',            // Poland (requires PLN billing currency)
    'sepa',            // Eurozone (one-time payments only)
    'satispay',        // Europe / Italy
    'credit',          // Fallback
    'debit'            // Fallback
  ],
  billing_currency: 'EUR',
  return_url: 'https://example.com/success'
});

Dodo mostra automaticamente solo i metodi pertinenti in base alla posizione del cliente. Un cliente olandese vedrà iDEAL; un cliente belga vedrà Bancontact.

Test

I metodi di pagamento europei possono essere testati in Test Mode. Il flusso di test simula il processo di autenticazione bancaria.

SEPA Direct Debit viene testato in modo diverso: invece di un flusso bancario simulato, inserisci direttamente un IBAN di test. Consulta IBAN SEPA di test.

Enable test mode

Usa le chiavi API di test di Dodo Payments.

Set appropriate billing address

Imposta il paese dell’indirizzo di fatturazione in modo che corrisponda al metodo di pagamento:

NL per iDEAL
BE per Bancontact
AT per EPS
PT per Multibanco
PL per BLIK (con valuta di fatturazione PLN)
IT per Satispay

Complete the test flow

Segui il flusso di autenticazione bancaria simulato nell’ambiente di test.

Buone pratiche

Always include regional methods for target markets

Se vendi a clienti olandesi, includi iDEAL. Non farlo equivale a non accettare Visa negli Stati Uniti: perderai una quantità significativa di vendite.

Match currency to region

La maggior parte dei metodi di pagamento europei richiede EUR: assicurati che i tuoi prezzi supportino le transazioni in euro. L’unica eccezione è BLIK, disponibile solo con la valuta di fatturazione PLN (złoty polacco).

Handle redirects gracefully

Tutti i metodi europei prevedono reindirizzamenti ai siti delle banche. Assicurati che la gestione dell’URL di ritorno sia affidabile e tenga conto degli utenti che abbandonano il flusso a metà.

Provide card fallbacks

Non tutti i clienti europei hanno accesso a questi metodi regionali (turisti, espatriati e così via). Includi sempre credit e debit come alternative.

Consider Multibanco timing

I pagamenti Multibanco tramite ATM possono richiedere ore per essere completati. Non bloccare l’evasione in attesa di un pagamento immediato: usa i webhook per la conferma asincrona.

Account for the SEPA 6-day delay

SEPA Direct Debit richiede fino a 6 giorni lavorativi per essere confermato. Non completare mai l’ordine al reindirizzamento del checkout o su payment.processing: concedi l’accesso solo dal webhook payment.succeeded e definisci le aspettative al checkout, in modo che i clienti sappiano che il loro ordine è in sospeso. Consulta Gestione del ritardo nella conferma.

Risoluzione dei problemi

European method not appearing

Verifica:

Il paese di fatturazione del cliente corrisponde a quello del metodo?
La valuta è impostata su EUR?
Il metodo è incluso in allowed_payment_method_types?

Soluzione: I metodi europei sono strettamente regionali. Un cliente con paese di fatturazione DE (Germania) non vedrà iDEAL, disponibile solo nei Paesi Bassi.

Bank authentication failed

Cause:

Il cliente ha annullato durante l’autenticazione bancaria
Il sistema di autenticazione della banca è temporaneamente non disponibile
Il cliente ha inserito credenziali errate

Soluzione: Il cliente deve riprovare. Se il problema persiste, suggerisci di provare un metodo di pagamento diverso.

Redirect not completing

Cause:

Il cliente ha chiuso il browser durante il reindirizzamento alla banca
Problemi di rete durante l’autenticazione
URL di ritorno configurato in modo errato

Soluzione: Verifica che l’URL di ritorno sia corretto e accessibile. Assicurati che gestisca sia gli stati di successo sia quelli di fallimento.

Multibanco payment pending

Causa: Il cliente ha ricevuto il riferimento del pagamento, ma non ha ancora pagato.Soluzione: Questo comportamento è previsto per i pagamenti basati su ATM. Attendi la conferma tramite webhook. Il riferimento scade generalmente dopo 24-72 ore.

SEPA payment stuck in processing

Causa: SEPA Direct Debit viene regolato in modo asincrono tramite la banca del cliente.Soluzione: Questo comportamento è previsto. Uno stato payment.processing può durare fino a 6 giorni lavorativi prima che l’addebito venga regolato. Attendi il webhook definitivo payment.succeeded (completa l’ordine) o payment.failed (non completare l’ordine); non considerare il reindirizzamento del checkout come una conferma. Consulta Gestione del ritardo nella conferma.

Conformità PSD2

Tutti i metodi di pagamento europei sono conformi alle normative PSD2 (Payment Services Directive 2):

Strong Customer Authentication (SCA) — Integrata nel flusso di autenticazione bancaria
Comunicazione sicura — Tutti i dati vengono trasmessi tramite canali sicuri
Protezione dei consumatori — Piena conformità ai diritti dei consumatori dell’UE

Pagine correlate

Payment Methods Overview

Visualizza tutti i metodi di pagamento supportati.

Adaptive Currency

Supporto delle valute e conversione automatica.

Checkout Guide

Guida completa all’implementazione del checkout.

Webhooks

Gestisci le conferme dei pagamenti in modo asincrono.

​Why Local European Payment Methods?

Higher Conversion

Lower Fraud

Real-Time Settlement

​Supported Methods

​iDEAL (Netherlands)

​How It Works

​Supported Banks

​Configuration

​Bancontact (Belgium)

​Features

​Configuration

​EPS (Austria)

​Features

​Supported Banks

​Configuration

​Multibanco (Portugal)

​Payment Options

​How ATM Payment Works

​Configuration

​BLIK (Polonia)

​How It Works

​Availability

​Configuration

​SEPA Direct Debit (Eurozona)

​Come funziona

​Cronologia del pagamento

​Disponibilità

​Configurazione

​IBAN SEPA di test

​Gestione del ritardo nella conferma

​Satispay (Europa)

​Funzionalità

​Disponibilità

​Configurazione

​Tipi di metodo API

​Checkout europeo multi-paese

​Test

​Buone pratiche

​Risoluzione dei problemi

​Conformità PSD2

​Pagine correlate

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Why Local European Payment Methods?

Supported Methods

iDEAL (Netherlands)

How It Works

Supported Banks

Configuration

Bancontact (Belgium)

Features

Configuration

EPS (Austria)

Features

Supported Banks

Configuration

Multibanco (Portugal)

Payment Options

How ATM Payment Works

Configuration

BLIK (Polonia)

How It Works

Availability

Configuration

SEPA Direct Debit (Eurozona)

Come funziona

Cronologia del pagamento

Disponibilità

Configurazione

IBAN SEPA di test

Gestione del ritardo nella conferma

Satispay (Europa)

Funzionalità

Disponibilità

Configurazione

Tipi di metodo API

Checkout europeo multi-paese

Test

Buone pratiche

Risoluzione dei problemi

Conformità PSD2

Pagine correlate