Carte di credito e debito

Le carte sono disponibili in ogni checkout di Dodo Payments, in tutti i Paesi e le valute supportati. Dodo Payments accetta le principali reti di carte, sostituisce i numeri delle carte con token ed esegue i controlli necessari per i pagamenti con carta, così non devi gestire dati grezzi delle carte.

Circuiti di carte supportati

Dodo Payments accetta le reti globali e diverse reti regionali.

Reti globali

Network	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	Incentrata sugli Stati Uniti, in crescita a livello globale
JCB	Leader in Giappone, in espansione in tutta l’Asia
UnionPay	Dominante in Cina
Diners Club	Viaggiatori internazionali premium

Network regionali

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

Configurazione

Le carte utilizzano due valori in allowed_payment_method_types:

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

Questa sessione offre solo pagamenti con carta:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_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 pagare con una carta di debito.

Autenticazione 3D Secure

3D Secure (3DS) chiede alla banca del titolare della carta di confermare l’identità del titolare, ad esempio tramite un codice monouso, una verifica biometrica o un’approvazione nell’app della banca. Questo riduce le frodi e i chargeback.

Quando viene attivato 3DS

Dodo Payments richiede 3DS quando:

Il network della carta lo richiede.
Lo richiede una normativa regionale, come la PSD2 in Europa.
La transazione viene segnalata come ad alto rischio.

Forzare 3DS

Per richiedere 3DS per ogni pagamento con carta della tua attività, attiva 3D Secure in Settings → Pricing. Per ignorare questa impostazione per una singola sessione di checkout, passa force_3ds:

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

Richiedere 3DS per ogni transazione riduce le frodi, ma può diminuire il tasso di conversione, perché alcuni clienti abbandonano il checkout durante l’autenticazione.

Gestire i fallimenti dell’autenticazione

Quando un pagamento richiede l’autenticazione 3DS, il pagamento passa attraverso stati intermedi prima di riuscire o fallire:

Stato	Significato	Cosa fare
`requires_customer_action`	Il cliente deve completare una verifica 3DS	Fai completare l’autenticazione al cliente 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 fallisce con uno di questi codici di rifiuto:

AUTHENTICATION_FAILURE: non è stato possibile autenticare il cliente.
AUTHENTICATION_REQUIRED: l’autenticazione è richiesta, ma non è stata eseguita.
AUTHENTICATION_TIMEOUT: il cliente non ha risposto in tempo.

Il riferimento Transaction Failures elenca l’azione consigliata per ogni codice.

Durante il checkout e al rinnovo

Durante il checkout (cliente presente): la verifica 3DS viene visualizzata durante il checkout. Se fallisce, chiedi al cliente di riprovare o di utilizzare un’altra carta.
Al rinnovo dell’abbonamento (cliente non presente): non è possibile mostrare una verifica 3DS in tempo reale. Se un rinnovo richiede l’autenticazione e fallisce, l’abbonamento passa a on_hold oppure prima a past_due se hai impostato un periodo di tolleranza. Per recuperarlo, chiedi al cliente di tornare e aggiornare il metodo di pagamento. Consulta Gestire i fallimenti dei pagamenti e Recupero dei pagamenti degli abbonamenti.

Metodi di pagamento salvati

I clienti che tornano possono pagare con una carta salvata durante un checkout precedente.

Tokenized

I numeri originali delle carte non vengono mai memorizzati.

PCI Compliant

Dodo Payments gestisce la conformità PCI.

Customer-Scoped

Ogni carta salvata appartiene a un solo cliente.

Abilitare le carte salvate

Per mostrare al checkout le carte salvate di un cliente che torna, passa show_saved_payment_methods: true con l’elemento customer_id esistente. Il valore predefinito è false.

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

Acquisti con un clic

Per addebitare una carta salvata senza mostrare il checkout, passa il relativo payment_method_id con confirm: true e l’elemento customer_id esistente. La sessione addebita direttamente la carta e non restituisce alcun checkout_url, quindi utilizza i webhook per conoscere il risultato del pagamento.

// `client` is an initialized DodoPayments client.
// Get the customer's saved payment methods
const methods = await client.customers.retrievePaymentMethods('cus_123');

// Charge the first saved card
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_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

Utilizza queste carte in modalità test. Per altri dati di test, consulta Procedura di test.

Successful Payments
Declined Payments

Regione	Brand	Numero della 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	Brand	Numero della carta	Scenario
US	Visa	`4000000000000002`	Rifiuto generico
US	Visa	`4000000000009995`	Fondi insufficienti
India	Visa	`4706131211212123`	Rifiuto generico
India	Mastercard	`5105105105105100`	Rifiuto generico

Le carte di test funzionano solo in modalità test. In modalità live, un pagamento effettuato con una carta di test fallisce.

Sicurezza e conformità

Dodo Payments applica queste protezioni ai pagamenti con carta:

Funzionalità	Descrizione
PCI DSS Level 1	Il livello più alto di certificazione PCI DSS
Tokenization	I numeri delle carte vengono tokenizzati al momento dell’inserimento
Fraud Scoring	Valutazione del rischio in tempo reale
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 a meno che non sia necessario. I clienti si aspettano che la loro carta preferita funzioni.

Display card logos

Mostra i loghi Visa, Mastercard e Amex sul tuo sito 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 rendono più veloci gli acquisti ripetuti per i clienti che tornano.

Risoluzione dei problemi

Card declined

Cause: fondi insufficienti, carta scaduta, CVV errato o protezione antifrode della banca.Soluzione: chiedi al cliente di controllare i dati o di provare una carta diversa. Cerca il codice di errore del rifiuto e l’azione consigliata nel riferimento Transaction Failures. Consulta Gestire i fallimenti dei pagamenti per gestire i rifiuti nel codice.

3DS authentication failed

Cause: il cliente ha abbandonato la verifica, il sistema della banca non era disponibile oppure la verifica è scaduta.Soluzione: riprova oppure chiedi al cliente di contattare la propria banca. Consulta Gestire i fallimenti dell’autenticazione per conoscere gli stati del pagamento e i codici di rifiuto coinvolti.

Card not supported

Cause: il network regionale non è supportato oppure la carta è una carta prepagata soggetta a restrizioni.Soluzione: chiedi al cliente di provare una carta di un network principale.

Pagine correlate

Payment Methods Overview

Tutti i metodi di pagamento supportati.

Upsells & Downsells

Acquisti con un clic usando le carte salvate.

Testing Process

Dati di test per ogni metodo di pagamento.

Subscriptions

Fatturazione ricorrente con le carte.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Circuiti di carte supportati

Reti globali

Network regionali

Configurazione

Autenticazione 3D Secure

Quando viene attivato 3DS

Forzare 3DS

Gestire i fallimenti dell’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

​Reti globali

​Network regionali

​Configurazione

​Autenticazione 3D Secure

​Quando viene attivato 3DS

​Forzare 3DS

​Gestire i fallimenti dell’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

Reti globali

Network regionali

Configurazione

Autenticazione 3D Secure

Quando viene attivato 3DS

Forzare 3DS

Gestire i fallimenti dell’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