Warum Pix anbieten?
Dominant in Brazil
Instant Settlement
Low Friction
Übersicht
Das Minimum ist das Checkout-Minimum für BRL und gilt daher für jede Zahlungsmethode bei einem BRL-Checkout. Eine BRL-Zahlung muss bei einmaligen Zahlungen außerdem mindestens dem Gegenwert von $0.50 und bei Abonnements von $1.00 entsprechen. Siehe Mindestbeträge.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:
- Ist die Abrechnungswährung
BRL? - Ist
pixinallowed_payment_method_typesenthalten? - Ist das Abrechnungsland des Kunden Brasilien (
BR)? Mit Adaptive Currency legt eine brasilianische Rechnungsadresse die Abrechnungswährung auf BRL fest. - Ist Adaptive Currency aktiviert?
- Erfüllt der Betrag das Mindestlimit von 0.50 BRL und das USD-Minimum?
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.