Why Offer Pix?
Dominant in Brazil
Instant Settlement
Low Friction
Overview
Minimibeloppet är checkout-minimibeloppet för BRL, så det gäller för alla betalningsmetoder i en BRL-checkout. En BRL-betalning måste också uppgå till minst motsvarande $0.50 för engångsbetalningar och $1.00 för prenumerationer. Se Minimibelopp.Så fungerar det
Kundupplevelse
- Kunden väljer Pix i checkouten och anger sitt CPF (det 11-siffriga brasilianska skatteidentifikationsnumret) i fältet Pix CPF.
- Kunden bekräftar betalningen. En QR-kod öppnas i ett helskärmsöverlägg, med Pix-koden och en knapp med texten Kopiera koden under den.
- Kunden öppnar sin bankapp, väljer Pix och skannar QR-koden eller klistrar in Pix-koden.
- Betalningen bekräftas inom några sekunder.
- Checkouten upptäcker den slutförda betalningen och omdirigerar kunden till din sida för lyckade betalningar.
Pix QR-koden upphör att gälla efter en begränsad tid. Om kunden inte betalar i tid måste de starta en ny checkout från din webbplats.
Konfiguration
API-metodtyp
Testning
1
Enable Test Mode
Stäng av reglaget Live Mode i sidofältet i dashboarden och använd API-nycklar som skapats i testläge.
2
Set Billing Currency to BRL
Aktivera Adaptive Currency. Skapa sedan en checkout-session med
billing_currency: 'BRL' och pix i allowed_payment_method_types.3
Enter Test CPF and Scan the QR Code
Ange
00000000000 (11 nollor) i fältet Pix CPF. Checkouten visar en test-QR-kod. Skanna den med telefonens kamera; du behöver inte ha en Pix- eller bankapp. QR-koden öppnar en testsida där du kan simulera en lyckad eller misslyckad betalning.Bästa praxis
Set billing currency to BRL
Set billing currency to BRL
Pix fungerar endast i checkouter som debiteras i BRL, och Dodo Payments debiterar endast i BRL när Adaptive Currency är aktiverat. Aktivera Adaptive Currency så att kunder i Brasilien får priser och debiteras i BRL.
Provide card fallbacks
Provide card fallbacks
Vissa brasilianska kunder föredrar att betala med kort. Inkludera
credit och debit som reservbetalningsmetoder.Handle QR code expiration
Handle QR code expiration
Pix QR-koder upphör att gälla efter en begränsad tid. Om en kund återkommer efter att koden har upphört att gälla skapar du en ny checkout session åt dem.
Felsökning
Pix not appearing at checkout
Pix not appearing at checkout
Kontrollera:
- Är faktureringsvalutan
BRL? - Ingår
pixiallowed_payment_method_types? - Är kundens faktureringsland Brasilien (
BR)? Med Adaptive Currency ställer en brasiliansk faktureringsadress in faktureringsvalutan till BRL. - Är Adaptive Currency aktiverat?
- Uppfyller beloppet minimibeloppet på 0.50 BRL och USD-minimibeloppet?
QR code expired
QR code expired
Orsak: Kunden slutförde inte betalningen inom giltighetstiden.Lösning: Kunden måste starta en ny checkout från din webbplats. Om du vill skicka en ny betalningslänk till kunden skapar du en ny checkout session.
Payment pending
Payment pending
Orsak: De flesta Pix-betalningar bekräftas inom några sekunder, men en bank kan ibland fördröja en överföring.Lösning: Använd webhooks
payment.succeeded och payment.failed för den slutliga betalningsstatusen i stället för retur-omdirigeringen. Om betalningen inte bekräftas inom några minuter ska du behandla den som misslyckad.