Why Offer Pix?
Dominant in Brazil
Instant Settlement
Low Friction
Overview
Il minimo corrisponde al minimo del checkout per BRL, quindi si applica a ogni metodo di pagamento su un checkout in BRL. Un pagamento in BRL deve inoltre essere almeno l’equivalente di $0.50 per i pagamenti una tantum e di $1.00 per gli abbonamenti. Consulta Importi minimi.Come funziona
Esperienza del cliente
- Il cliente seleziona Pix al checkout e inserisce il proprio CPF (il codice fiscale brasiliano di 11 cifre) nel campo Pix CPF.
- 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.
- Il cliente apre la propria app bancaria, seleziona Pix e scansiona il codice QR oppure incolla il codice Pix.
- Il pagamento viene confermato entro pochi secondi.
- 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
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
Set billing currency to BRL
Set billing currency to BRL
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.
Provide card fallbacks
Provide card fallbacks
Alcuni clienti brasiliani preferiscono pagare con carta. Includi
credit e debit come metodi di pagamento alternativi.Handle QR code expiration
Handle QR code expiration
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
Pix not appearing at checkout
Pix not appearing at checkout
Verifica:
- La valuta di fatturazione è
BRL? pixè incluso inallowed_payment_method_types?- Il paese di fatturazione del cliente è il Brasile (
BR)? Con Adaptive Currency, un indirizzo di fatturazione brasiliano imposta la valuta di fatturazione su BRL. - Adaptive Currency è abilitato?
- L’importo soddisfa il minimo di 0.50 BRL e il minimo in USD?
QR code expired
QR code expired
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.
Payment pending
Payment pending
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.