Carte di credito e debito

I pagamenti con carta sono alla base dei pagamenti online: sono accettati in tutto il mondo e considerati affidabili dai clienti. Dodo Payments supporta tutti i principali circuiti di carte, con protezione antifrode integrata e conformità PCI.

Circuiti di carte supportati

Circuiti globali

Circuito	Copertura
Visa	Leader globale, oltre 4 miliardi di carte in tutto il mondo
Mastercard	Presenza globale, solide funzionalità di sicurezza
American Express	Titolari di carte premium, maggiore capacità di spesa
Discover	Incentrato sugli Stati Uniti, in crescita a livello globale
JCB	Leader in Giappone, in espansione in tutta l’Asia
UnionPay	Dominante in Cina, oltre 8 miliardi di carte
Diners Club	Viaggiatori internazionali premium

Circuiti regionali

Circuito	Regione
Interac	Circuito di debito canadese
Cartes Bancaires	Circuito nazionale francese
Korean Local Cards	Circuiti nazionali coreani
Rupay	Circuito nazionale indiano

Configurazione

Usa questi valori in allowed_payment_method_types:

Tipo	Descrizione
`credit`	Tutte le carte di credito
`debit`	Tutte le carte di debito

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['credit', 'debit'],
  return_url: 'https://example.com/success'
});

Includi sia credit sia debit, a meno che tu non abbia un motivo specifico per escluderne uno. Molti clienti preferiscono le carte di debito, che spesso hanno commissioni più basse.

Autenticazione 3D Secure

3D Secure (3DS) aggiunge un livello di autenticazione che riduce le frodi e i chargeback verificando l’identità del titolare della carta.

Quando viene attivato 3DS

3DS viene attivato automaticamente quando:

È richiesto dal circuito della carta
È richiesto dalle normative regionali (ad esempio, PSD2 in Europa)
La transazione viene contrassegnata come ad alto rischio

Forzare 3DS

Puoi richiedere 3DS per tutte le transazioni:

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  force_3ds: true,
  return_url: 'https://example.com/success'
});

L’attivazione di 3DS per tutte le transazioni riduce le frodi, ma può diminuire leggermente la conversione, poiché alcuni clienti abbandonano il pagamento durante l’autenticazione.

Gestione degli errori di autenticazione

Quando un pagamento richiede l’autenticazione 3DS, passa attraverso stati intermedi prima di essere completato o rifiutato:

Stato	Significato	Cosa fare
`requires_customer_action`	Il cliente deve completare una verifica 3DS	Fai completare al cliente l’autenticazione durante il checkout
`requires_payment_method`	Il cliente non ha mai fornito un metodo di pagamento (non ha inserito i dati o ha abbandonato la richiesta) — di solito si tratta di un abbandono, non di un rifiuto	Ricontatta il cliente per completare il checkout; consulta Recupero dei carrelli abbandonati

Se l’autenticazione non viene completata, il pagamento non va a buon fine con uno di questi codici di rifiuto:

AUTHENTICATION_FAILURE — il cliente non ha potuto essere autenticato.
AUTHENTICATION_REQUIRED — l’autenticazione è richiesta ma non è stata eseguita.
AUTHENTICATION_TIMEOUT — il cliente non ha risposto in tempo.

Consulta il riferimento Errori delle transazioni per l’azione consigliata per ciascun caso.

Durante il checkout e al rinnovo

Durante il checkout (cliente presente): Il cliente è presente, quindi la verifica 3DS viene mostrata durante il checkout. Se non va a buon fine, chiedigli di riprovare o di usare un’altra carta.
Al rinnovo dell’abbonamento (cliente non presente): Il cliente non è presente, quindi una verifica 3DS non può essere mostrata in tempo reale. Se un rinnovo richiede l’autenticazione, l’abbonamento passa a on_hold. Recuperalo chiedendo al cliente di tornare e aggiornare il metodo di pagamento — consulta Gestione degli errori di pagamento e Gestione dei mancati pagamenti degli abbonamenti.

Metodi di pagamento salvati

I clienti possono salvare le proprie carte per effettuare più rapidamente i checkout futuri.

Tokenized

I numeri originali delle carte non vengono mai memorizzati.

PCI Compliant

Dodo gestisce tutta la conformità.

Customer-Scoped

Carte associate a clienti specifici.

Abilitare le carte salvate

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  show_saved_payment_methods: true,
  customer: { customer_id: 'cus_existing_123' },
  return_url: 'https://example.com/success'
});

Acquisti con un clic

// Get customer's saved payment methods
const methods = await client.customers.retrievePaymentMethods('cus_123');

// Use saved card for instant checkout
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  customer: { customer_id: 'cus_123' },
  payment_method_id: methods.items[0].payment_method_id,
  confirm: true,
  return_url: 'https://example.com/success'
});

Test

Successful Payments
Declined Payments

Regione	Circuito	Numero di carta	Scadenza	CVV
US	Visa	`4242424242424242`	06/32	123
US	Mastercard	`5555555555554444`	06/32	123
India	Visa	`4576238912771450`	06/32	123
India	Mastercard	`5409162669381034`	06/32	123

Regione	Circuito	Numero di carta	Scenario
US	Visa	`4000000000000002`	Rifiuto generico
US	Mastercard	`4000000000009995`	Fondi insufficienti
India	Visa	`4706131211212123`	Rifiuto generico
India	Mastercard	`5105105105105100`	Rifiuto generico

Le carte di test funzionano solo in modalità di test. Non usarle mai per transazioni in produzione.

Sicurezza e conformità

Funzionalità	Descrizione
PCI DSS Level 1	Livello di certificazione più elevato
Tokenization	I numeri delle carte vengono immediatamente tokenizzati
Fraud Scoring	Valutazione del rischio in tempo reale
AVS	Address Verification Service
CVV Validation	Verifica del codice di sicurezza
3D Secure	Autenticazione del titolare della carta

Best practice

Accept all major networks

Non limitare i tipi di carta se non è necessario. I clienti si aspettano di poter usare la propria carta preferita.

Display card logos

Mostra i loghi Visa, Mastercard e Amex nel checkout per aumentare la fiducia.

Handle declines gracefully

Mostra messaggi di errore chiari. Non mostrare ai clienti i codici di errore grezzi.

Enable saved cards for returning customers

I metodi di pagamento salvati aumentano significativamente la conversione per gli acquisti ripetuti.

Risoluzione dei problemi

Card declined

Cause: Fondi insufficienti, carta scaduta, CVV errato, protezione antifrode della banca.Soluzione: Chiedi al cliente di verificare i dati o di provare un’altra carta. Cerca il codice di rifiuto specifico Error Code e l’azione consigliata nel riferimento Errori delle transazioni, e consulta Gestione degli errori di pagamento per la gestione programmatica.

3DS authentication failed

Cause: Il cliente ha abbandonato il pagamento, il sistema della banca non è disponibile, timeout.Soluzione: Riprova o chiedi al cliente di contattare la propria banca. Consulta Gestione degli errori di autenticazione per gli stati del pagamento e i codici di rifiuto coinvolti.

Card not supported

Cause: La carta regionale non è supportata, restrizioni sulle carte prepagate.Soluzione: Il cliente dovrebbe provare un’altra carta appartenente a un circuito principale.

Pagine correlate

Payment Methods Overview

Tutti i metodi di pagamento supportati.

Upsells & Downsells

Acquisti con un clic usando carte salvate.

Testing Process

Guida completa ai test.

Subscriptions

Fatturazione ricorrente con le carte.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Circuiti di carte supportati

Circuiti globali

Circuiti regionali

Configurazione

Autenticazione 3D Secure

Quando viene attivato 3DS

Forzare 3DS

Gestione degli errori di autenticazione

Durante il checkout e al rinnovo

Metodi di pagamento salvati

Tokenized

PCI Compliant

Customer-Scoped

Abilitare le carte salvate

Acquisti con un clic

Test

Sicurezza e conformità

Best practice

Risoluzione dei problemi

Pagine correlate

Payment Methods Overview

Upsells & Downsells

Testing Process

Subscriptions

​Circuiti di carte supportati

​Circuiti globali

​Circuiti regionali

​Configurazione

​Autenticazione 3D Secure

​Quando viene attivato 3DS

​Forzare 3DS

​Gestione degli errori di autenticazione

​Durante il checkout e al rinnovo

​Metodi di pagamento salvati

Tokenized

PCI Compliant

Customer-Scoped

​Abilitare le carte salvate

​Acquisti con un clic

​Test

​Sicurezza e conformità

​Best practice

​Risoluzione dei problemi

​Pagine correlate

Payment Methods Overview

Upsells & Downsells

Testing Process

Subscriptions

Circuiti di carte supportati

Circuiti globali

Circuiti regionali

Configurazione

Autenticazione 3D Secure

Quando viene attivato 3DS

Forzare 3DS

Gestione degli errori di autenticazione

Durante il checkout e al rinnovo

Metodi di pagamento salvati

Abilitare le carte salvate

Acquisti con un clic

Test

Sicurezza e conformità

Best practice

Risoluzione dei problemi

Pagine correlate