Metodi di Pagamento

Dodo Payments supporta un’ampia gamma di metodi di pagamento per aiutarti a servire i clienti a livello globale. Tutti i metodi di pagamento elencati diventano disponibili automaticamente una volta che il tuo account commerciante è verificato e la modalità live è abilitata.

Attivazione Automatica: Non è necessaria alcuna configurazione aggiuntiva da parte tua. Tutti i metodi di pagamento sono pre-configurati e gestiti da Dodo Payments. Puoi eventualmente limitare quali metodi appaiono al checkout utilizzando la configurazione API descritta di seguito.

Metodi di Pagamento Supportati

La seguente tabella fornisce un riferimento rapido per tutti i metodi di pagamento disponibili, la loro disponibilità regionale e le principali limitazioni:

Metodo di Pagamento	Paesi Supportati	Valute Supportate	Supporta Abbonamenti
Carte di Credito	Globale	Tutte le valute	Sì
Carte di Debito	Globale	Tutte le valute	Sì
Apple Pay	Globale (Escl. IN)	Tutte le valute	Sì
Google Pay	Globale (Escl. IN)	Tutte le valute	Sì
Amazon Pay	Globale (Escl. IN)	USD	No
Cash App Pay	US	USD	No
Afterpay (BNPL)	US, UK	USD, GBP	No
Klarna (BNPL)	US, Europa*	USD, EUR, GBP, DKK, NOK, SEK, CZK, RON, PLN, CHF	No
PayPal	Globale	EUR, GBP	No
UPI	India	INR	Sì*
Rupay (Credito/Debito)	India	INR	Sì*
Bancontact	Belgio	EUR	No
EPS	Austria	EUR	No
iDEAL	Paesi Bassi	EUR	No
Multibanco	Portogallo	EUR	No

Ogni transazione deve soddisfare il minimo richiesto per ogni valuta. Per USD, il minimo è 0,50 USD. I minimi per altre valute variano in base alla regione. Consulta Valute Supportate & Minimi

Klarna e Afterpay richiedono un importo minimo di transazione di 50,01 USD (o equivalente nelle valute supportate) per l’idoneità al checkout. Le transazioni al di sotto di questa soglia non saranno idonee per queste opzioni di pagamento BNPL.Per dettagli sui paesi supportati da Klarna, fai riferimento alla sezione BNPL qui sotto.

Metodi di Pagamento Indiani: Gli abbonamenti UPI e Rupay sono supportati con mandati conformi al RBI. Consulta la sezione Abbonamento con Mandati Conformi al RBI per dettagli importanti sui limiti dei mandati e sui ritardi di elaborazione.

Dettagli sui Metodi di Pagamento

Carte di Credito e Debito

Dodo Payments accetta tutte le principali reti di carte di credito e debito a livello globale. Puoi accettare:

Visa – Rete globale affidabile e ampiamente accettata
Mastercard – Rete robusta e sicura con portata globale
American Express – Vantaggi premium e forte servizio clienti
Discover – Premi competitivi, forte presenza negli Stati Uniti
JCB – Rete di carte asiatica leader con portata in espansione
UnionPay – Dominante in Cina e Asia, con crescente accettazione globale
Interac – Rete di pagamento sicura per debito in Canada
Cartes Bancaires – Ampiamente utilizzata in Francia
Diners Club – Carta internazionale premium con vantaggi esclusivi
Carte Locali Coreane – Supporto per le reti di carte domestiche coreane

Portafogli Digitali

Offri ai clienti un checkout veloce e sicuro utilizzando portafogli digitali:

Apple Pay – Paga facilmente su iOS, macOS e watchOS
Google Pay – Pagamenti sicuri su Android, web e in negozio
PayPal – Pagamenti globali in EUR e GBP (non disponibile per abbonamenti)
Cash App Pay – Pagamenti mobili per clienti statunitensi (non disponibile per abbonamenti)
Amazon Pay – Usa le credenziali Amazon per un checkout semplice (non disponibile per abbonamenti)

Compra Ora Paga Dopo (BNPL)

Aumenta la conversione offrendo opzioni di pagamento flessibili:

Klarna – Abilita pagamenti flessibili con le opzioni di Klarna: paga in 4 rate, paga in 30 giorni o finanzia il tuo acquisto. Klarna è disponibile negli Stati Uniti e in 19 paesi europei, tra cui Austria, Belgio, Repubblica Ceca, Danimarca, Finlandia, Francia, Germania, Grecia, Irlanda, Italia, Paesi Bassi, Norvegia, Polonia, Portogallo, Romania, Spagna, Svezia, Svizzera e Regno Unito. Le valute supportate includono USD, EUR, GBP, DKK, NOK, SEK, CZK, RON, PLN e CHF.
Afterpay – Consenti ai clienti di suddividere gli acquisti in quattro pagamenti senza interessi. Afterpay è disponibile negli Stati Uniti e nel Regno Unito, supportando pagamenti in USD e GBP.

UPI e Rupay (India)

Accetta le principali opzioni di pagamento indiane:

UPI – I clienti scansionano un codice QR o utilizzano app (Google Pay, PhonePe, Paytm, CRED) per trasferimenti bancari istantanei e senza contatto
Carte Rupay – Pagamenti sicuri con carte di credito e debito tramite la rete di carte domestiche dell’India

Metodi di Pagamento Europei

Offri opzioni europee localizzate per aumentare le conversioni:

iDEAL (Paesi Bassi) – Pagamenti online olandesi istantanei
Bancontact (Belgio) – Metodo di carta di debito affidabile in Belgio
Multibanco (Portogallo) – Metodo di pagamento portoghese per bonifici e pagamenti ATM
EPS (Austria) – Pagamenti bancari online diretti in Austria

Configurazione dei Metodi di Pagamento

Sebbene tutti i metodi di pagamento siano automaticamente disponibili in base alla posizione e alla valuta del cliente, puoi eventualmente limitare quali opzioni di pagamento appaiono durante il checkout utilizzando il parametro allowed_payment_method_types.

Quando Configurare i Metodi di Pagamento

Potresti voler configurare i metodi di pagamento consentiti per:

Controllare quali opzioni di pagamento appaiono ai clienti in base ai requisiti della tua attività
Limitare i metodi di pagamento per specifici tipi di prodotto o flussi di transazione
Mantenere coerenza tra le diverse esperienze di pagamento
Ottimizzare l’esperienza di checkout per il tuo pubblico target

Implementazione

Aggiungi parametro alla richiesta API

Includi il campo allowed_payment_method_types nella tua richiesta di creazione di pagamento o abbonamento:

{
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "apple_pay"
  ]
}

Testa la configurazione

Verifica che solo i metodi di pagamento specificati appaiano al checkout.

Testa la disponibilità dei metodi di pagamento con diverse posizioni e valute dei clienti per assicurarti che la configurazione funzioni come previsto.

Endpoint API

Questa configurazione è supportata dai seguenti endpoint:

Crea Sessione di Checkout

Crea sessioni di checkout con metodi di pagamento consentiti.

Crea Pagamento

Pagamenti una tantum con metodi consentiti.

Crea Abbonamento

Pagamenti di abbonamento con metodi ricorrenti.

Esempi di Implementazione

Pagamento Una Tantum
Abbonamento
Focus Regionale

{
  "amount": 1000,
  "currency": "usd",
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "apple_pay",
    "google_pay"
  ]
}

{
  "product_id": "prod_123",
  "customer_id": "cust_456",
  "allowed_payment_method_types": [
    "credit",
    "debit"
  ]
}

{
  "amount": 5000,
  "currency": "eur",
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "ideal",
    "bancontact",
    "sepa"
  ]
}

Migliori Pratiche

Comportamento predefinito

Se allowed_payment_method_types non è specificato, tutti i metodi di pagamento idonei saranno disponibili in base alla posizione del cliente, alla valuta e al tipo di transazione. Usa questo parametro solo quando hai bisogno di limitare i metodi di pagamento.

Considerazioni Regionali

Considera il tuo mercato target quando selezioni i metodi di pagamento. Includere opzioni specifiche per la regione (come UPI per l’India o iDEAL per i Paesi Bassi) può migliorare significativamente i tassi di conversione in quei mercati.

Monitora e ottimizza

Tieni traccia di quali metodi di pagamento i tuoi clienti utilizzano più frequentemente e adatta i tuoi metodi consentiti in base ai modelli di utilizzo effettivi e ai dati di conversione.

Considerazioni Importanti

La disponibilità dei metodi di pagamento dipende da molteplici fattori:

Posizione del Cliente: Alcuni metodi di pagamento sono specifici per regione
Impostazioni del Commerciante: La configurazione e le capacità del tuo account
Valuta: I metodi di pagamento supportati variano in base alla valuta
Tipo di Transazione: Alcuni metodi non supportano abbonamenti o hanno importi minimi

Aggiungere un metodo di pagamento a allowed_payment_method_types non garantisce che appaia: deve anche essere idoneo in base a questi fattori.

Risoluzione dei Problemi

Metodo di pagamento non appare al checkout

Possibili cause:

Il metodo di pagamento non è incluso in allowed_payment_method_types
Il metodo di pagamento non è supportato per la posizione del cliente
Il metodo di pagamento non supporta la valuta della transazione
Per abbonamenti: il metodo di pagamento non supporta pagamenti ricorrenti
L’importo della transazione è al di sotto della soglia minima (ad es. metodi BNPL)

Soluzione: Verifica che tutti i requisiti di idoneità siano soddisfatti e controlla la configurazione della tua richiesta API.

Metodi di pagamento imprevisti che appaiono

Possibili cause:

Il parametro allowed_payment_method_types non viene passato correttamente
Potrebbero esserci configurazioni in conflitto nel tuo dashboard commerciante

Soluzione: Rivedi il payload della tua richiesta API e assicurati che il parametro sia formattato correttamente come un array di stringhe.

Metodo di pagamento regionale non disponibile

Possibili cause:

La posizione del cliente non corrisponde alla regione supportata dal metodo di pagamento
La valuta non è supportata dal metodo di pagamento regionale
Il tuo account commerciante potrebbe non essere abilitato per quel specifico metodo di pagamento

Soluzione: Verifica la compatibilità regionale e della valuta e contatta il supporto se ritieni che il metodo dovrebbe essere disponibile.

Problemi di abbonamento con metodi di pagamento indiani

Addebito dell’abbonamento non riuscito dopo aggiornamento/diminuzione:

L’importo del nuovo addebito potrebbe superare il limite del mandato esistente (soglia di Rs 15.000)
Il cliente potrebbe dover aggiornare il proprio metodo di pagamento per stabilire un nuovo mandato

Soluzione: Invita il cliente ad aggiornare il proprio metodo di pagamento o ad adattare l’importo dell’abbonamento per rimanere entro i limiti del mandato.Abbonamento in attesa dopo l’inizio dell’addebito:

Il cliente potrebbe aver annullato il mandato durante la finestra di elaborazione di 48 ore
Il cliente potrebbe non aver autorizzato un addebito di alto valore (≥Rs 15.000)

Soluzione: Monitora gli eventi webhook per cancellazioni di mandato e fallimenti di pagamento. Implementa una logica di ripetizione o invita i clienti a ristabilire il proprio metodo di pagamento.Deduzione del pagamento ritardata:

Comportamento normale: gli abbonamenti con carte indiane e UPI hanno un ritardo di 48 ore tra l’inizio dell’addebito e la deduzione effettiva
Questo ritardo può estendersi fino a 2-3 ore aggiuntive a seconda delle API bancarie

Soluzione: Questo è un comportamento previsto. Non attivare vantaggi o crediti fino a quando non ricevi conferma di pagamento tramite webhook.

Aggiornamento dei metodi di pagamento per abbonamenti

Quando aggiornare i metodi di pagamento:

La carta del cliente scade o viene sostituita
Il cliente desidera utilizzare un metodo di pagamento diverso
L’abbonamento è in stato on_hold a causa di un pagamento non riuscito
Il metodo di pagamento deve essere cambiato per qualsiasi motivo

Per abbonamenti attivi: Aggiornare il metodo di pagamento per un abbonamento attivo aggiorna semplicemente il metodo di pagamento per i futuri rinnovi. Non viene creato alcun addebito immediato.Per abbonamenti in attesa: Quando un abbonamento è in stato on_hold (a causa di un rinnovo non riuscito o di un addebito di cambio piano non riuscito), aggiornare il metodo di pagamento:

Crea automaticamente un addebito per i restanti importi dovuti
Genera una fattura per l’addebito
Elabora il pagamento utilizzando il nuovo metodo di pagamento
Riattiva l’abbonamento allo stato active dopo un pagamento riuscito

// Update payment method for active subscription
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// Or use existing payment method
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'existing',
  payment_method_id: 'pm_abc123'
});

// For on_hold subscription - automatically creates charge
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

if (response.payment_id) {
  // Charge created for remaining dues
  // Redirect customer to response.payment_link
  // Monitor webhooks: payment.succeeded → subscription.active
}

Eventi Webhook:

Per abbonamenti on_hold: Riceverai payment.succeeded seguito da subscription.active dopo l’aggiornamento riuscito del metodo di pagamento
Monitora questi eventi per tracciare lo stato di riattivazione dell’abbonamento

Aggiorna Metodo di Pagamento Riferimento API

Visualizza la documentazione API completa per l’aggiornamento dei metodi di pagamento.

Stati di Abbonamento

Scopri di più sugli stati di abbonamento, inclusi attivi e in attesa.

Espandere le Opzioni di Pagamento

Aggiungiamo continuamente nuovi metodi di pagamento a Dodo Payments. Questa pagina sarà aggiornata man mano che più opzioni diventano disponibili. Se hai bisogno di un metodo di pagamento specifico non elencato qui, ti preghiamo di contattarci a [email protected], e prenderemo in considerazione l’aggiunta al nostro piano.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous