Wie nehme ich Pix-Zahlungen auf meiner Website an?
Zeigen Sie dem Käufer einen Pix-QR-Code, daneben die Version zum Kopieren und Einfügen, der bereits Ihren Pix-Schlüssel und den genauen Betrag der Bestellung enthält. Es gibt zwei Wege dorthin: einen statischen Code, den Ihre eigene Website ohne jede Bankanbindung aus Ihrem Schlüssel erzeugen kann, und einen dynamischen Code, den Ihre Bank oder Ihr Zahlungsanbieter über seine API ausstellt. Der statische Weg braucht keine Integration, und das Geld geht direkt auf Ihr Konto — aber nichts teilt Ihrer Website mit, dass die Zahlung eingegangen ist; das prüfen Sie in Ihrer Bank. Der dynamische Weg ist der, der eine automatische Bestätigung liefert.
Statisch oder dynamisch: die Entscheidung, die alles andere bestimmt
Die brasilianische Zentralbank definiert beide in ihrem Manual de Padrões para Iniciação do Pix (aktuell ist Version 2.10.0). Bei einem statischen Code steckt alles, was zum Auslösen der Zahlung nötig ist, im Bild selbst: eine Pflichtangabe, ein im DICT-Verzeichnis registrierter Pix-Schlüssel, und vier optionale — eine Transaktionskennung, ein Freitextfeld, der Betrag und ein Feld, das nur Pix Saque nutzt. Das Handbuch sagt, dass ein statischer Code direkt von der Software des Empfängers erstellt werden kann, und hält in Großbuchstaben fest, dass seine Erstellung NICHT Teil der Pix-API ist. Ihre Website kann ihn bauen; eine Bank muss nicht beteiligt sein.
Ein dynamischer Code enthält dagegen eine URL auf dem Server Ihres Zahlungsanbieters, die die App des Käufers beim Scannen abruft, um Betrag und Transaktionsdaten zu holen. Weil nur Ihr Anbieter diese URL bereitstellen kann, kommt ein dynamischer Code immer von einem Anbieter — der Pix-API Ihrer Bank oder einem Zahlungsdienstleister —, und derselbe Anbieter kann Ihrer Website melden, wenn das Geld eingeht. Die Faustregel: Muss die Zahlung automatisch etwas freischalten (einen Download, ein Konto, einen Termin), brauchen Sie den dynamischen Weg und etwas auf dem Server, das die Meldung empfängt — dieselbe Grenze, die braucht meine Website ein Backend zieht. Kann ein Mensch vor dem Versand in der Bank nachsehen, reicht ein statischer Code mit Betrag.
Was wir auf den Seiten gefunden haben, die wir hosten
AgentCeres — der AI Growth Officer auf agentceres.com — hostet Seiten, die Kunden mit ihrem Agenten bauen, und die meisten dieser Kunden sitzen in Brasilien. Als wir am 23. September 2026 gezählt haben, erwähnten 54 von 173 veröffentlichten Kundenseiten Pix, und 78 zeigten Preise in Real. Das Problem lag darin, wie sie kassierten:
- Neun Seiten enthielten einen Pix-Code, den die KI von Hand geschrieben hatte. Ein BR Code endet mit einer Prüfsumme über alle Zeichen davor, und das Handbuch merkt an, dass schon die Reihenfolge der Felder sie verändert. Ein Code mit einem falschen Zeichen lässt sich nicht lesen — mindestens ein Kunde hat uns gesagt, dass die App seiner Bank seinen Code nicht scannen konnte.
- Zweiundzwanzig Seiten zeigten den Pix-Schlüssel als Text. Das funktioniert, aber der Käufer tippt den Betrag selbst ein, sodass falsche oder unvollständige Zahlungen leicht passieren. Ein Inhaber hatte darum gebeten, seine CPF zu verwenden — damit steht eine persönliche Steuernummer auf einer öffentlichen Seite; ein zufälliger Schlüssel (chave aleatória) erfüllt denselben Zweck ohne das.
- Die Zahlung wurde vom Käufer "nachgewiesen". Bestellformulare ließen den Käufer ein Kästchen ankreuzen, dass er bezahlt habe, und einen Screenshot hochladen — was nur beweist, dass jemand einen Screenshot machen kann.
Also haben wir den statischen Weg in unser Hosting eingebaut, und die Entscheidungen dabei sind der übertragbare Teil. Der Code wird aus dem eigenen Schlüssel des Inhabers erzeugt, sodass die Bank des Käufers direkt an die Bank des Inhabers zahlt und wir das Geld nie halten. Der Betrag wird auf unserem Server aus den Preisen der veröffentlichten Seite berechnet, nie aus einer Summe, die der Browser schickt, denn alles auf der Seite kann der Besucher verändern. Lässt sich der Betrag nicht berechnen, schlägt die Erzeugung fehl, statt auf einen Code ohne Betrag auszuweichen. Und die Bestätigung bleibt manuell: Der Inhaber prüft seine Bank und markiert die Bestellung als bezahlt, und bis dahin steht auf der Seite des Käufers, dass auf den Verkäufer gewartet wird.
Einen statischen Code richtig machen
- Erzeugen Sie ihn mit einem Werkzeug oder einer Bibliothek, die dem BR-Code-Standard folgt — nie durch Abtippen oder Bearbeiten der Zeichenkette; die Prüfsumme am Ende muss stimmen.
- Nehmen Sie den Betrag in den Code auf, sobald der Preis feststeht, und berechnen Sie ihn dort, wo der Besucher ihn nicht ändern kann.
- Vergeben Sie pro Bestellung eine kurze Transaktionskennung (bis zu 25 Zeichen), damit Sie jede Gutschrift auf dem Kontoauszug ihrer Bestellung zuordnen können.
- Zeigen Sie die Zeichenkette zum Kopieren neben dem QR-Bild: Wer auf demselben Handy bezahlt, kann den eigenen Bildschirm nicht scannen.
- Bezahlen Sie einmal selbst mit einem kleinen Betrag, bevor es ein Kunde tut.
Ein Detail spielt dem Käufer in die Hände. Laut Handbuch sieht der Zahlende vor dem Bestätigen immer den Namen, der im DICT zu diesem Schlüssel registriert ist; der im Code eingetragene Empfängername wird ignoriert. So kann der Käufer prüfen, wer das Geld wirklich erhält, egal was auf der Seite steht — ein Hinweis darauf neben dem Button lohnt sich. Wenn Sie den Verkauf lieber in einem Gespräch als auf der Seite abschließen, ist ein WhatsApp-Button, der die Bestellung verschickt, die übliche Alternative, und beides passt gut zusammen.
FAQ
- Brauche ich eine CNPJ oder ein Zahlungsgateway, um Pix auf meiner Website anzunehmen?
- Für einen statischen Code nicht: Er braucht nur einen Pix-Schlüssel, der auf Ihr Konto registriert ist, und auch Privatpersonen können Schlüssel registrieren. Ein Gateway oder die Pix-API Ihrer Bank wird nötig, sobald Sie dynamische Codes und automatische Bestätigung wollen.
- Kann ich denselben Pix-QR-Code für jede Bestellung verwenden?
- Ja, wenn er keinen Betrag enthält — dann tippt der Käufer den Preis ein, was Fehler begünstigt und die Zuordnung von Gutschriften zu Bestellungen erschwert. Ein Code pro Bestellung mit Betrag und Kennung vermeidet beides.
- Woran erkenne ich, dass eine Pix-Zahlung angekommen ist?
- Bei einem statischen Code, indem Sie in Ihrer Bank nachsehen — achten Sie auf den Betrag und, falls gesetzt, auf die Transaktionskennung. Gibt Ihnen Ihr Anbieter Zugang zur Pix-API, lassen sich Zahlungen auf einen statischen Code mit Transaktionskennung auch dort abfragen — der erste Schritt zur Automatisierung.
Soll das jemand für dich erledigen?
AgentCeres ist ein gemanagtes KI-Marketingteam: Spezialisten erstellen die Entwürfe, du gibst frei, was rausgeht. 14 Tage kostenlos testen, ab $39/Monat.