Why Offer Pix?
Dominant in Brazil
Pix är den mest använda betalningsmetoden i Brasilien, före kreditkort och boleto. Brasiliens centralbank rapporterar att Pix stod för 54,7 % av alla betalningstransaktioner under andra halvan av 2025.
Instant Settlement
Pix-överföringar slutförs på några sekunder, när som helst och alla dagar på året, så du behöver inte vänta på något bankhanteringsfönster.
Low Friction
Kunden skannar en QR-kod eller klistrar in en Pix-kod i sin bankapp. De behöver inte ange kortnummer eller bankuppgifter.
Overview
Minimibeloppet är checkoutens minimibelopp för BRL, så det gäller för alla betalningsmetoder i en checkout i BRL.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 debiteringsvalutan
BRL? - Ingår
pixiallowed_payment_method_types? - Är kundens debiteringsland Brasilien (
BR)? Med Adaptive Currency ställer en brasiliansk faktureringsadress in debiteringsvalutan till BRL. - Är Adaptive Currency aktiverat?
- Uppgår beloppet till minst 0.50 BRL?
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.Relaterade sidor
Payment Methods Overview
Se alla betalningsmetoder som stöds.
Adaptive Currency
Debiterа kunder i deras lokala valuta, inklusive BRL.
Checkout Guide
Fullständig guide till implementering av checkout.
Webhooks
Hantera betalningsbekräftelser asynkront.
Testing Process
Testdata och vägledning för checkout-testning.