Skip to main content
Consenti ai clienti brasiliani di pagare dalla loro app bancaria scansionando un codice QR o incollando un codice Pix. Pix è il sistema di pagamento istantaneo del Brasile, creato dalla Banca Centrale del Brasile (Banco Central do Brasil). Trasferisce il denaro in tempo reale, 24 ore al giorno, inclusi weekend e festività. Dodo Payments offre Pix per pagamenti una tantum e abbonamenti addebitati in BRL.

​
Why Offer Pix?

Dominant in Brazil

Pix è il metodo di pagamento più utilizzato in Brasile, davanti alle carte di credito e ai boleto. La Banca Centrale del Brasile riferisce che Pix ha rappresentato il 54,7% di tutte le transazioni di pagamento nella seconda metà del 2025.

Instant Settlement

I trasferimenti Pix vengono completati in pochi secondi, a qualsiasi ora e in qualsiasi giorno dell’anno, quindi non è necessario attendere una finestra di elaborazione bancaria.

Low Friction

Il cliente scansiona un codice QR o incolla un codice Pix nella propria app bancaria. Non deve inserire numeri di carta o coordinate bancarie.

​
Overview

Il minimo corrisponde al minimo del checkout per BRL, quindi si applica a tutti i metodi di pagamento in un checkout in BRL.

​
Come funziona

​
Esperienza del cliente

  1. Il cliente seleziona Pix al checkout e inserisce il proprio CPF (il codice fiscale brasiliano di 11 cifre) nel campo Pix CPF.
  2. Il cliente conferma il pagamento. Un codice QR si apre in una sovrapposizione a schermo intero, con il codice Pix e un pulsante Copia il codice sotto di esso.
  3. Il cliente apre la propria app bancaria, seleziona Pix e scansiona il codice QR oppure incolla il codice Pix.
  4. Il pagamento viene confermato entro pochi secondi.
  5. Il checkout rileva il pagamento completato e reindirizza il cliente alla pagina di esito positivo.
Il codice QR Pix scade dopo un periodo di tempo limitato. Se il cliente non paga in tempo, deve avviare un nuovo checkout dal tuo sito.

​
Configurazione

Pix è disponibile nei checkout per pagamenti una tantum e abbonamenti addebitati in BRL. Dodo Payments addebita in BRL solo quando Adaptive Currency è abilitato, quindi abilitalo prima di offrire Pix.

​
Tipo di metodo API

​
Test

1

Enable Test Mode

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

Set Billing Currency to BRL

Abilita Adaptive Currency. Quindi crea una sessione di checkout con billing_currency: 'BRL' e pix in allowed_payment_method_types.
3

Enter Test CPF and Scan the QR Code

Nel campo Pix CPF, inserisci 00000000000 (11 zeri). Il checkout mostra un codice QR di test. Scansionalo con la fotocamera del telefono; non è necessaria un’app Pix o bancaria. Il codice QR apre una pagina di test in cui puoi simulare un pagamento riuscito o non riuscito.

​
Procedure consigliate

Pix funziona solo sui checkout addebitati in BRL e Dodo Payments addebita in BRL solo quando Adaptive Currency è abilitato. Abilita Adaptive Currency affinché ai clienti in Brasile vengano mostrati preventivi e addebiti in BRL.
Alcuni clienti brasiliani preferiscono pagare con carta. Includi credit e debit come metodi di pagamento alternativi.
I codici QR Pix scadono dopo un periodo di tempo limitato. Se un cliente torna dopo la scadenza del codice, crea una nuova sessione di checkout per lui.

​
Risoluzione dei problemi

Verifica:
  1. La valuta di addebito è BRL?
  2. pix è incluso in allowed_payment_method_types?
  3. Il paese di addebito del cliente è il Brasile (BR)? Con Adaptive Currency, un indirizzo di addebito brasiliano imposta la valuta di addebito su BRL.
  4. Adaptive Currency è abilitato?
  5. L’importo soddisfa il minimo di 0.50 BRL?
Soluzione: Pix viene offerto solo sui checkout in BRL. Controlla la valuta e l’indirizzo di addebito nella richiesta API.
Causa: Il cliente non ha completato il pagamento entro il periodo di validità.Soluzione: Il cliente deve avviare un nuovo checkout dal tuo sito. Per inviargli un nuovo link di pagamento, crea una nuova sessione di checkout.
Causa: La maggior parte dei pagamenti Pix viene confermata entro pochi secondi, ma occasionalmente una banca può ritardare un trasferimento.Soluzione: Usa i webhook payment.succeeded e payment.failed per lo stato finale del pagamento invece del reindirizzamento di ritorno. Se il pagamento non viene confermato entro pochi minuti, consideralo non riuscito.

​
Pagine correlate

Payment Methods Overview

Consulta tutti i metodi di pagamento supportati.

Adaptive Currency

Addebita i clienti nella loro valuta locale, inclusa BRL.

Checkout Guide

Guida completa all’implementazione del checkout.

Webhooks

Gestisci le conferme dei pagamenti in modo asincrono.

Testing Process

Dati di test e indicazioni per i test del checkout.
Ultima modifica il 26 settembre 2026