Entwicklerintegration

Zahlungssitzungen, Ereignisse und Abwicklung verbinden

Das Payfux-Integrationsmodell verbindet die Erstellung einer Zahlungssitzung mit den Referenzen, die ein Betreiber zur Verarbeitung von Ereignissen, zur Gutschrift an die vorgesehene Einheit und zum Abgleich der Abwicklung benötigt. Produktbeispiele erklären die Abfolge; für genaue Endpoints, Anfragefelder, Authentifizierungsanforderungen und Ereignisschemas ist die aktuelle API-Dokumentation maßgeblich. Verfügbarkeit und Integrationsverhalten werden für jeden Kunden bei der technischen Prüfung bestätigt.

Dokumentation lesen

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.

  1. 01

    Sitzung erstellen

    Senden Sie erforderlichen Betrag, Währung, Geschäftsreferenz und Rückleitungskontext in der aktuell dokumentierten Anfragestruktur.

  2. 02

    Zahlungserlebnis bereitstellen

    Leiten Sie den Kunden in den konfigurierten Checkout oder Zahlungsweg, der für diese Sitzung zurückgegeben wurde.

  3. 03

    Dokumentierte Ereignisse verarbeiten

    Validieren und verarbeiten Sie die Ereignistypen und Felder, die in der aktuellen API-Dokumentation beschrieben sind.

  4. 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.

01

Referenzdesign

Wählen Sie beständige Spieler-, Auftrags- oder Rechnungsreferenzen, die sowohl im Betreibersystem als auch im Payfux-Datensatz auffindbar sind.

02

Ereignisverarbeitung

Verarbeiten Sie nur dokumentierte Ereignisfelder und Status und bewahren Sie die empfangene Referenz für Prüfung und Abgleich auf.

03

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.

04

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
Live-Support / Onboarding-BeratungLive-Support