European Payment Methods - Dodo Payments Documentation

Accetta iDEAL, Bancontact, EPS, Multibanco, BLIK, SEPA Direct Debit e Satispay per raggiungere i clienti europei che preferiscono pagare dal proprio conto bancario o tramite un’app di pagamento locale invece che con una carta. Nei mercati in cui un metodo locale è il modo più comune per pagare online, offrirlo può aumentare la conversione.

Why Local European Payment Methods?

Higher Conversion

iDEAL è il metodo di pagamento online più utilizzato nei Paesi Bassi. Senza di esso, perdi i clienti olandesi che non pagheranno in un altro modo.

Bank Authentication

Per i metodi autenticati tramite banca, il cliente approva il pagamento nell’app bancaria o sul sito della propria banca.

Real-Time Settlement

La maggior parte dei metodi in questa pagina conferma il pagamento durante il checkout. SEPA Direct Debit e i pagamenti Multibanco presso gli ATM vengono confermati in un secondo momento.

Metodi supportati

Ogni metodo viene offerto solo quando il checkout corrisponde alla relativa valuta e al tipo di fatturazione:

Metodo	Paese	Valuta	Abbonamenti
iDEAL	Paesi Bassi	EUR	No
Bancontact	Belgio	EUR	No
EPS	Austria	EUR	No
Multibanco	Portogallo	EUR	No
BLIK	Polonia	PLN	No
SEPA Direct Debit	Area euro	EUR	Sì
Satispay	Europa (Italia)	EUR	Sì

iDEAL (Paesi Bassi)

iDEAL è il metodo di pagamento online più utilizzato nei Paesi Bassi. Si collega direttamente a tutte le principali banche olandesi e il cliente approva ogni pagamento tramite la propria banca.

Come funziona

Il cliente seleziona iDEAL, sceglie la propria banca e si autentica al suo interno:

Banche supportate

iDEAL funziona con tutte le principali banche olandesi, tra cui:

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

Configurazione

Per offrire iDEAL, includi ideal in allowed_payment_method_types e fattura in EUR:

// `client` is an initialized DodoPayments client.
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 (Belgio)

Bancontact è il sistema di pagamento nazionale del Belgio. Quasi tutte le banche belghe lo utilizzano per i pagamenti online.

Funzionalità

Funziona con le carte di debito Bancontact che i clienti belgi già possiedono
Supporta i pagamenti nell’app mobile Bancontact
Conferma il pagamento durante il checkout
Non richiede alcuna registrazione aggiuntiva da parte del cliente

Configurazione

Per offrire Bancontact, includi bancontact_card e fattura in EUR:

// `client` is an initialized DodoPayments client.
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) consente ai clienti austriaci di pagare tramite bonifico bancario online dal proprio conto.

Funzionalità

Si collega direttamente alle banche austriache
Conferma il pagamento durante il checkout
È molto apprezzato dai consumatori austriaci

Banche supportate

EPS funziona con le principali banche austriache, tra cui:

Erste Bank
Bank Austria
Raiffeisen
BAWAG
Volksbank

Configurazione

Per offrire EPS, includi eps e fattura in EUR:

// `client` is an initialized DodoPayments client.
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 (Portogallo)

Multibanco è la rete interbancaria portoghese. I clienti possono pagare online oppure pagare un riferimento di pagamento presso un bancomat.

Opzioni di pagamento

I clienti possono completare un pagamento Multibanco in tre modi:

Online banking: un bonifico bancario tramite il servizio di online banking del cliente.
Pagamento presso un bancomat: il cliente riceve un riferimento di pagamento e lo paga presso un qualsiasi bancomat Multibanco.
Mobile banking: un pagamento nell’app bancaria del cliente.

Come funziona il pagamento presso un bancomat

Per un pagamento presso un bancomat, il cliente riceve un riferimento di pagamento come questo:

Entity: 12345
Reference: 123 456 789
Amount: €50.00

Il cliente paga utilizzando questo riferimento presso un qualsiasi bancomat portoghese o tramite online banking. Il riferimento è valido per un periodo limitato, indicato al cliente insieme al riferimento.

Configurazione

Per offrire Multibanco, includi multibanco e fattura in EUR:

// `client` is an initialized DodoPayments client.
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'
});

Un pagamento Multibanco presso un bancomat viene completato quando il cliente paga il riferimento, anche molto tempo dopo il checkout. Usa i webhook per sapere quando il pagamento è stato confermato.

BLIK (Polonia)

BLIK è il metodo di pagamento mobile più popolare in Polonia. Il cliente paga con un codice monouso di 6 cifre generato nell’app bancaria. I pagamenti BLIK vengono fatturati in PLN (złoty polacchi), non in EUR.

Come funziona

Il cliente genera un codice nell’app bancaria, lo inserisce durante il checkout e approva il pagamento nell’app:

Disponibilità

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

Configurazione

Per offrire BLIK, includi blik e imposta billing_currency su PLN:

// `client` is an initialized DodoPayments client.
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 la valuta di fatturazione PLN e Dodo Payments fattura in PLN solo quando Adaptive Currency è abilitato. Abilita Adaptive Currency affinché i clienti polacchi vengano fatturati in PLN e BLIK diventi disponibile.

SEPA Direct Debit (Area euro)

SEPA Direct Debit consente ai clienti nell’Area euro di pagare dal proprio conto bancario invece che con una carta. È disponibile nei checkout in EUR, sia per i pagamenti una tantum sia per gli abbonamenti, quando il Paese di fatturazione è Austria, Belgio, Estonia, Finlandia, Francia, Germania, Irlanda, Italia, Lettonia, Lituania, Paesi Bassi, Portogallo, Slovacchia o Spagna.

SEPA Direct Debit non è istantaneo. La conferma di un pagamento può richiedere fino a 6 giorni lavorativi. A differenza di un pagamento con carta, l’autorizzazione del cliente durante il checkout non significa che il denaro sia stato accreditato. Non completare l’ordine dal 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. La banca esegue l’addebito in modo asincrono, quindi il pagamento rimane nello stato processing finché non raggiunge un esito finale:

Tempistiche del pagamento

Un pagamento SEPA attraversa queste fasi:

Fase	Quando	Stato del pagamento	Significato
Autorizzazione	Durante il checkout	`processing`	Il cliente ha approvato l’addebito ed è stato reindirizzato indietro. Il denaro non è ancora stato trasferito, quindi non completare l’ordine.
Conferma	Fino a 6 giorni lavorativi dopo	`succeeded`	La banca ha autorizzato 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 e informa il cliente.

La conferma arriva giorni dopo che il cliente ha lasciato il tuo sito, quindi deve essere il tuo gestore dei webhook, non il reindirizzamento del checkout, a concedere l’accesso. Consulta Gestione del ritardo di conferma.

Disponibilità

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

Configurazione

Per offrire SEPA Direct Debit, includi sepa e fattura in EUR:

// `client` is an initialized DodoPayments client.
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 di test SEPA

In modalità test, inserisci uno di questi IBAN durante il 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 per 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 di successo di un altro Paese dell’Area euro:

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

Usa gli IBAN di test con ritardo per verificare che sia il tuo gestore dei webhook, non il reindirizzamento del checkout, a concedere l’accesso. I pagamenti SEPA vengono confermati molto tempo dopo che il cliente ha lasciato il checkout.

Gestione del ritardo di conferma

SEPA viene regolato fino a 6 giorni lavorativi dopo il checkout, quindi il reindirizzamento del browser non può dirti se un pagamento è stato autorizzato. Gestisci l’evasione dell’ordine tramite gli eventi webhook. Attiva l’evento type e gestisci ogni fase:

Tipo di evento	Quando viene attivato	Cosa fare
`payment.processing`	Il cliente ha autorizzato l’addebito durante il checkout ed è stato reindirizzato indietro.	Non completare l’ordine. Contrassegna l’ordine come in sospeso. Facoltativamente, informa il cliente che il pagamento è in elaborazione.
`payment.succeeded`	La banca ha autorizzato 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.

Completa l’ordine su payment.succeeded dal webhook, non sul reindirizzamento del checkout o su payment.processing. Il reindirizzamento avviene non appena il cliente autorizza l’addebito, giorni prima che il denaro venga accreditato.

Il seguente gestore Express verifica la firma di ogni evento con client.webhooks.unwrap prima di agire sull’evento. Per configurare l’endpoint, consulta la guida Webhooks. Per tutti gli eventi, consulta la guida agli eventi Webhook.

Handling SEPA payment events

import express from 'express';
import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
});
const app = express();

// markOrderPending, fulfillOrder, and markOrderFailed are your own order functions.
app.post('/webhooks/dodo', express.raw({ type: 'application/json' }), async (req, res) => {
  let event;
  try {
    // Checks the webhook-id, webhook-signature, and webhook-timestamp headers.
    event = client.webhooks.unwrap(req.body.toString(), { headers: req.headers });
  } catch {
    return res.status(400).send('Invalid signature');
  }

  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, so it's safe to fulfill now.
      await fulfillOrder(event.data.payment_id);
      break;
    }
    case 'payment.failed': {
      // The debit could not be collected (for example, insufficient funds).
      await markOrderFailed(event.data.payment_id);
      // Notify the customer and prompt a retry.
      break;
    }
  }

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

Definisci le aspettative del cliente durante il checkout. L’accesso viene concesso solo dopo che l’addebito è stato autorizzato, quindi informa i clienti SEPA che il loro ordine è in elaborazione e che li avviserai quando il pagamento sarà confermato. In caso contrario, potrebbero aspettarsi un accesso immediato, come per un pagamento con carta.

Satispay (Europa)

Satispay è una rete europea di pagamenti mobili con la sua più ampia base di utenti in Italia. I clienti pagano dall’app Satispay senza condividere i dati della carta o del conto bancario. I pagamenti Satispay vengono fatturati in EUR.

Funzionalità

Pagamenti basati sull’app, indipendenti dai circuiti delle carte
Ampia diffusione in Italia e utilizzo in crescita in altri mercati europei
Supporto per pagamenti una tantum e abbonamenti

Disponibilità

Valuta di fatturazione: EUR
Tipo di transazione: pagamenti una tantum e abbonamenti
Importo: da €0.50 a €999,999.99 per pagamento

Configurazione

Per offrire Satispay, includi satispay e fattura in EUR:

// `client` is an initialized DodoPayments client.
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 metodi API

Trasmetti questi valori in allowed_payment_method_types:

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

Checkout europeo multi-Paese

Per vendere in diversi Paesi europei, includi ogni metodo regionale, oltre alle carte come opzione alternativa:

// `client` is an initialized DodoPayments client.
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 and subscriptions)
    'satispay',        // Europe / Italy
    'credit',          // Fallback
    'debit'            // Fallback
  ],
  billing_currency: 'EUR',
  return_url: 'https://example.com/success'
});

Dodo Payments mostra a ogni cliente solo i metodi che corrispondono al suo Paese di fatturazione e alla sua valuta. Un cliente olandese vede iDEAL, mentre un cliente belga vede Bancontact. Questa sessione fattura in EUR, quindi BLIK non viene visualizzato.

Test

Puoi testare i metodi di pagamento europei in modalità test. Il flusso di test simula il passaggio di autenticazione bancaria.

SEPA Direct Debit utilizza un flusso di test diverso. Invece di un flusso bancario simulato, inserisci direttamente un IBAN di test. Consulta IBAN di test SEPA.

Enable Test Mode

Disattiva l’interruttore Live Mode nella barra laterale della dashboard e usa le chiavi API create in modalità test.

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 in modalità test.

Best practice

Always include regional methods for target markets

Se vendi a clienti olandesi, includi iDEAL. Escluderlo equivale a non accettare Visa negli Stati Uniti: perderesti una quota significativa delle vendite.

Match currency to region

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

Handle redirects gracefully

La maggior parte dei metodi europei reindirizza il cliente alla propria banca o app di pagamento. Assicurati che la gestione del tuo URL di ritorno funzioni anche per i clienti che interrompono il flusso a metà.

Provide card fallbacks

Non tutti i clienti in Europa possono utilizzare questi metodi regionali, ad esempio turisti ed expat. Includi credit e debit come alternative. Se non è disponibile alcun metodo, la sessione di checkout non va a buon fine.

Consider Multibanco timing

Un pagamento Multibanco presso un bancomat può richiedere ore per essere completato. Non bloccare l’evasione dell’ordine in attesa di un pagamento immediato. Usa i webhook per la conferma asincrona.

Account for the SEPA 6-day delay

La conferma di SEPA Direct Debit può richiedere fino a 6 giorni lavorativi. Non completare l’ordine sul reindirizzamento del checkout o su payment.processing. Concedi l’accesso solo dal webhook payment.succeeded e informa i clienti durante il checkout che il loro ordine è in sospeso. Consulta Gestione del ritardo di conferma.

Risoluzione dei problemi

European method not appearing

Verifica:

Il Paese di fatturazione del cliente corrisponde al Paese del metodo?
La valuta di fatturazione è EUR o PLN per BLIK?
Il metodo è incluso in allowed_payment_method_types?
Il checkout riguarda un pagamento una tantum? iDEAL, Bancontact, EPS, Multibanco e BLIK non sono disponibili per gli abbonamenti.

Soluzione: I metodi specifici per Paese vengono visualizzati solo nel Paese corrispondente. Un cliente con Paese di fatturazione DE (Germania) non vede iDEAL, disponibile solo nei Paesi Bassi.

Bank authentication failed

Cause:

Il cliente ha annullato il processo durante l’autenticazione bancaria.
Il sistema di autenticazione della banca era temporaneamente non disponibile.
Il cliente ha inserito credenziali errate.

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

Redirect not completing

Cause:

Il cliente ha chiuso il browser durante il reindirizzamento alla banca.
Un problema di rete ha interrotto l’autenticazione.
L’URL di ritorno è configurato in modo errato.

Soluzione: Verifica che l’URL di ritorno sia corretto e raggiungibile e che gestisca sia gli stati di successo sia quelli di errore.

Multibanco payment pending

Causa: Il cliente ha ricevuto un riferimento di pagamento ma non lo ha ancora pagato.Soluzione: Questo comportamento è previsto per i pagamenti presso un bancomat. Attendi la conferma del webhook. Il riferimento scade dopo il periodo limitato indicato al cliente.

SEPA payment stuck in processing

Causa: SEPA Direct Debit viene autorizzato 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 autorizzato. Attendi il webhook finale 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 di conferma.

Pagine correlate

Payment Methods Overview

Consulta 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

Bank Authentication

Real-Time Settlement

​Metodi supportati

​iDEAL (Paesi Bassi)

​Come funziona

​Banche supportate

​Configurazione

​Bancontact (Belgio)

​Funzionalità

​Configurazione

​EPS (Austria)

​Funzionalità

​Banche supportate

​Configurazione

​Multibanco (Portogallo)

​Opzioni di pagamento

​Come funziona il pagamento presso un bancomat

​Configurazione

​BLIK (Polonia)

​Come funziona

​Disponibilità

​Configurazione

​SEPA Direct Debit (Area euro)

​Come funziona

​Tempistiche del pagamento

​Disponibilità

​Configurazione

​IBAN di test SEPA

​Gestione del ritardo di conferma

​Satispay (Europa)

​Funzionalità

​Disponibilità

​Configurazione

​Tipi di metodi API

​Checkout europeo multi-Paese

​Test

​Best practice

​Risoluzione dei problemi

​Pagine correlate

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Why Local European Payment Methods?

Metodi supportati

iDEAL (Paesi Bassi)

Come funziona

Banche supportate

Configurazione

Bancontact (Belgio)

Funzionalità

Configurazione

EPS (Austria)

Funzionalità

Banche supportate

Configurazione

Multibanco (Portogallo)

Opzioni di pagamento

Come funziona il pagamento presso un bancomat

Configurazione

BLIK (Polonia)

Come funziona

Disponibilità

Configurazione

SEPA Direct Debit (Area euro)

Come funziona

Tempistiche del pagamento

Disponibilità

Configurazione

IBAN di test SEPA

Gestione del ritardo di conferma

Satispay (Europa)

Funzionalità

Disponibilità

Configurazione

Tipi di metodi API

Checkout europeo multi-Paese

Test

Best practice

Risoluzione dei problemi

Pagine correlate