01 / Ablauf
Die Geschäftsreferenz durch jedes Ereignis erhalten
Die Integration ist am leichtesten zu betreiben, wenn Zahlung, Spieler oder Auftrag und Abwicklungsdatensätze von Beginn an gemeinsame Referenzen haben.
- 01
Sitzung erstellen
Senden Sie erforderlichen Betrag, Währung, Geschäftsreferenz und Rückleitungskontext in der aktuell dokumentierten Anfragestruktur.
- 02
Zahlungserlebnis bereitstellen
Leiten Sie den Kunden in den konfigurierten Checkout oder Zahlungsweg, der für diese Sitzung zurückgegeben wurde.
- 03
Dokumentierte Ereignisse verarbeiten
Validieren und verarbeiten Sie die Ereignistypen und Felder, die in der aktuellen API-Dokumentation beschrieben sind.
- 04
Gutschreiben und abgleichen
Verbinden Sie Ereignis, vorgesehenen Spieler oder Auftrag, gutgeschriebenen Betrag und Abwicklungsdatensatz über die Zahlungsreferenz.
02 / Betrieb
Integrationsentscheidungen, die den Betrieb beeinflussen
Eine brauchbare Integration öffnet nicht nur den Checkout. Sie erhält die Referenzen, Status und Fehlerpfade, die der Betreiber nach dem Start benötigt.
Referenzdesign
Wählen Sie beständige Spieler-, Auftrags- oder Rechnungsreferenzen, die sowohl im Betreibersystem als auch im Payfux-Datensatz auffindbar sind.
Ereignisverarbeitung
Verarbeiten Sie nur dokumentierte Ereignisfelder und Status und bewahren Sie die empfangene Referenz für Prüfung und Abgleich auf.
Rückleitungsverhalten
Behandeln Sie die Rückkehr des Kunden als Oberflächennavigation und nicht als endgültigen Beleg für den Abschluss einer Zahlung oder Abwicklung.
Abgleichspfad
Verbinden Sie Zahlungs- und Abwicklungsdatensätze in den eigenen Systemen des Betreibers, damit Abweichungen anhand der Referenz untersucht werden können.
03 / Voraussetzungen
Die aktuelle Dokumentation ist maßgeblich
Marketingbeispiele beschreiben die Integrationsabfolge, definieren jedoch keine produktiven Endpoints, Payloads, Signaturen, Wiederholungsversuche, Statuswerte oder Service-Level.
- Verwenden Sie ausschließlich die Authentifizierung und Anfragefelder aus der aktuellen API-Dokumentation für die Kundenumgebung.
- Behandeln Sie die Browser-Rückleitung nicht als maßgeblichen Zahlungsnachweis; verwenden Sie das dokumentierte serverseitige Status- und Ereignismodell.
- Testen Sie den Umgang mit Fehlern, Duplikaten, Verzögerungen und Statusänderungen anhand des für die Integration dokumentierten Verhaltens.
04 / Fragen
Häufige Fragen von Betreibern
Wo stehen die aktuellen Payfux-API-Schemas?
Aktuelle Schemas, Authentifizierungsanforderungen und Anfragefelder stehen in der Payfux-API-Dokumentation. Codebeispiele auf Produktseiten dienen der Erklärung und ersetzen sie nicht.
Soll die Browser-Rückleitung eine Zahlung als abgeschlossen markieren?
Nein. Die Rückleitung des Kunden ist Navigation. Der Betreiber sollte für Gutschrift und Abgleich den dokumentierten serverseitigen Zahlungsstatus und Ereignisnachweise verwenden.
Verspricht Payfux einen bestimmten Zeitplan für Ereigniswiederholungen?
Auf dieser Seite wird kein Zeitplan für Wiederholungsversuche zugesagt. Implementieren Sie das Ereignis- und Wiederherstellungsverhalten aus der aktuellen Kundendokumentation.
Welche Geschäftsreferenz sollte ein Betreiber senden?
Verwenden Sie die beständige Spieler-, Kunden-, Rechnungs- oder Auftragsreferenz, die die dokumentierte Integration verlangt, und bewahren Sie sie im Betreibersystem auf.
Sind Test- und Produktivdatensätze austauschbar?
Nein. Halten Sie Zugangsdaten, Endpoints, Datensätze und Abgleich der Umgebungen getrennt und beachten Sie die in der Dokumentation beschriebenen Umgebungskontrollen.
Entwicklerdokumentation
Beginnen Sie mit den aktuellen Anfrage- und Ereignisschemas
Nutzen Sie die Payfux-Dokumentation für das exakte Integrationsverhalten und stimmen Sie anschließend die Zahlungsreferenzen mit Ihren Betreibersystemen ab.
Dokumentation lesen
