Zum Hauptinhalt springen
Pix ist das Sofortzahlungssystem Brasiliens, das von der Zentralbank von Brasilien (Banco Central do Brasil) erstellt wurde. Es ermöglicht 24/7 Echtzeitüberweisungen, auch an Wochenenden und Feiertagen, und ist die beliebteste Zahlungsmethode in Brasilien.

​
Warum Pix anbieten?

Dominant in Brazil

Pix ist die am häufigsten verwendete Zahlungsmethode in Brasilien und übertrifft Kreditkarten und Boleto.

Instant Settlement

Zahlungen werden in Sekunden bestätigt, 24/7/365 — kein Warten auf Bankbearbeitungsfenster.

Low Friction

Kunden zahlen via QR-Code oder durch Kopieren und Einfügen eines Schlüssels — keine Kartennummern oder Bankdaten erforderlich.

​
Übersicht

DetailWert
RechnungswährungBRL
Unterstützte LänderBrasilien
AbonnementsNein
Mindestbetrag$0.50
AbwicklungSofort

​
Wie es funktioniert

​
Kundenerfahrung

  1. Kunde wählt Pix beim Checkout
  2. Ein QR-Code und ein Schlüssel zum Kopieren und Einfügen werden angezeigt
  3. Kunde öffnet seine Banking-App und scannt den QR-Code oder fügt den Schlüssel ein
  4. Zahlung wird sofort bestätigt
  5. Kunde wird zur Erfolgsseite weitergeleitet
Pix QR-Codes verfallen typischerweise nach einer bestimmten Zeit. Wenn der Kunde die Zahlung nicht rechtzeitig abschließt, muss er den Checkout neu starten.

​
Konfiguration

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['pix', 'credit', 'debit'],
  billing_currency: 'BRL',
  return_url: 'https://example.com/success'
});

​
API-Methode

TypMethodeLand
pixPixBrasilien

​
Testen

1

Enable test mode

Verwenden Sie Ihre Dodo Payments Test-API-Schlüssel.
2

Set billing currency to BRL

Stellen Sie sicher, dass die Rechnungswährung in Ihrem Checkout-Antrag auf BRL gesetzt ist.
3

Enter test CPF and scan the QR code

Wenn nach einer Pix-CPF gefragt wird, geben Sie 1234567890 ein. Ein Test-QR-Code wird generiert — scannen Sie ihn mit Ihrer normalen Handykamera (keine Pix-App erforderlich). Sie werden zu einer Stripe-Testseite weitergeleitet, auf der Sie die Transaktion als Erfolg oder Fehlschlag simulieren können.

​
Beste Praktiken

Pix funktioniert nur mit BRL. Stellen Sie sicher, dass Ihre Preisgestaltung Transaktionen mit brasilianischem Real für den brasilianischen Markt unterstützt.
Nicht alle brasilianischen Kunden bevorzugen möglicherweise Pix. Bieten Sie immer credit und debit als Ausweichmöglichkeiten an.
Pix QR-Codes verfallen nach einer bestimmten Zeit. Stellen Sie sicher, dass Ihr Checkout Ablaufzeiten elegant handhabt und Kunden ermöglicht, den Code neu zu generieren.

​
Fehlerbehebung

Prüfen:
  1. Rechnungswährung ist auf BRL gesetzt?
  2. pix in allowed_payment_method_types enthalten?
  3. Kundenland für Rechnungsstellung ist Brasilien?
Lösung: Pix ist nur für BRL-Transaktionen verfügbar. Überprüfen Sie die Währung und die Rechnungsadresse in Ihrem API-Antrag.
Ursache: Der Kunde hat die Zahlung nicht innerhalb des Ablauffensters abgeschlossen.Lösung: Der Kunde muss den Checkout neu starten, um einen neuen QR-Code zu generieren.
Ursache: Pix-Zahlungen werden in den meisten Fällen sofort bestätigt, aber gelegentlich können bankseitige Verzögerungen auftreten.Lösung: Überwachen Sie Webhooks zur Bestätigung der Zahlung. 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

Währungsunterstützung und automatische Umrechnung.

Checkout Guide

Komplette Anleitung zur Checkout-Implementierung.

Webhooks

Asynchrone Bestätigung von Zahlungen.
Last modified on April 1, 2026