Warum Pix anbieten?
Dominant in Brazil
Pix ist die meistgenutzte Zahlungsmethode in Brasilien und liegt damit vor Kreditkarten und Boleto. Die brasilianische Zentralbank berichtet, dass Pix in der zweiten Hälfte des Jahres 2025 54,7 % aller Zahlungstransaktionen ausmachte.
Instant Settlement
Pix-Überweisungen werden an jedem Tag des Jahres und zu jeder Uhrzeit innerhalb von Sekunden abgeschlossen, sodass keine Bankverarbeitungszeiten abgewartet werden müssen.
Low Friction
Der Kunde scannt einen QR-Code oder fügt einen Pix-Code in seiner Banking-App ein. Er muss keine Kartennummern oder Bankdaten eingeben.
Übersicht
Der Mindestbetrag entspricht dem Checkout-Mindestbetrag für BRL und gilt daher für jede Zahlungsmethode in einem BRL-Checkout.So funktioniert es
Kundenerfahrung
- Der Kunde wählt beim Checkout Pix aus und gibt seine CPF (die 11-stellige brasilianische Steuer-ID) in das Feld Pix CPF ein.
- Der Kunde bestätigt die Zahlung. Ein QR-Code wird in einer Vollbildüberlagerung geöffnet, darunter befinden sich der Pix-Code und eine Schaltfläche Code kopieren.
- Der Kunde öffnet seine Banking-App, wählt Pix aus und scannt den QR-Code oder fügt den Pix-Code ein.
- Die Zahlung wird innerhalb von Sekunden bestätigt.
- Checkout erkennt die abgeschlossene Zahlung und leitet den Kunden auf Ihre Erfolgsseite weiter.
Der Pix-QR-Code läuft nach einer begrenzten Zeit ab. Wenn der Kunde nicht rechtzeitig bezahlt, muss er einen neuen Checkout über deine Website starten.
Konfiguration
API-Methodentyp
Testen
1
Enable Test Mode
Deaktivieren Sie den Schalter Live-Modus in der Seitenleiste des Dashboards und verwenden Sie API-Schlüssel, die im Testmodus erstellt wurden.
2
Set Billing Currency to BRL
Aktivieren Sie Adaptive Currency. Erstellen Sie anschließend eine Checkout-Session mit
billing_currency: 'BRL' und pix in allowed_payment_method_types.3
Enter Test CPF and Scan the QR Code
Geben Sie im Feld Pix CPF
00000000000 (11 Nullen) ein. Checkout zeigt einen Test-QR-Code an. Scannen Sie ihn mit der Kamera Ihres Telefons; eine Pix- oder Banking-App ist nicht erforderlich. Der QR-Code öffnet eine Testseite, auf der Sie eine erfolgreiche oder fehlgeschlagene Zahlung simulieren können.Best Practices
Set billing currency to BRL
Set billing currency to BRL
Pix funktioniert nur bei Checkouts, die in BRL abgerechnet werden, und Dodo Payments rechnet nur dann in BRL ab, wenn Adaptive Currency aktiviert ist. Aktivieren Sie Adaptive Currency, damit Kunden in Brasilien Preise in BRL angezeigt bekommen und in BRL abgerechnet werden.
Provide card fallbacks
Provide card fallbacks
Einige brasilianische Kunden bevorzugen die Zahlung per Karte. Fügen Sie
credit und debit als alternative Zahlungsmethoden hinzu.Handle QR code expiration
Handle QR code expiration
Pix-QR-Codes laufen nach einer begrenzten Zeit ab. Wenn ein Kunde nach Ablauf des Codes zurückkehrt, erstelle eine neue Checkout-Session für ihn.
Fehlerbehebung
Pix not appearing at checkout
Pix not appearing at checkout
Prüfen Sie:
- Ist die Abrechnungswährung
BRL? - Ist
pixinallowed_payment_method_typesenthalten? - Ist das Abrechnungsland des Kunden Brasilien (
BR)? Bei aktiviertem Adaptive Currency legt eine brasilianische Rechnungsadresse die Abrechnungswährung auf BRL fest. - Ist Adaptive Currency aktiviert?
- Erreicht der Betrag den Mindestbetrag von 0.50 BRL?
QR code expired
QR code expired
Ursache: Der Kunde hat die Zahlung nicht innerhalb des Ablaufzeitraums abgeschlossen.Lösung: Der Kunde muss einen neuen Checkout über deine Website starten. Um ihm einen neuen Zahlungslink zu senden, erstelle eine neue Checkout-Session.
Payment pending
Payment pending
Ursache: Die meisten Pix-Zahlungen werden innerhalb von Sekunden bestätigt, aber eine Bank kann eine Überweisung gelegentlich verzögern.Lösung: Verwenden Sie die Webhooks
payment.succeeded und payment.failed für den endgültigen Zahlungsstatus anstelle der Weiterleitung zurück zur Website. Wenn die Zahlung nicht innerhalb weniger Minuten bestätigt wird, behandeln Sie sie als fehlgeschlagen.Verwandte Seiten
Payment Methods Overview
Alle unterstützten Zahlungsmethoden anzeigen.
Adaptive Currency
Rechnen Sie Kunden in ihrer Landeswährung ab, einschließlich BRL.
Checkout Guide
Vollständiger Leitfaden zur Checkout-Implementierung.
Webhooks
Zahlungsbestätigungen asynchron verarbeiten.
Testing Process
Testdaten und Anleitungen zum Testen des Checkouts.