Einheitliche Operationsnummer
Sie verknüpft Spieler, Betrag, Währung, Zahlungsmethode, Zahlungsprovider und die vollständige Verarbeitungshistorie.
Dokumentation / Zahlungsablauf
So funktioniert die Zahlungs-API
Prüfen Sie den vollständigen Zahlungsweg: von der Erstellung einer Einzahlung und Zahlungsbestätigung bis zur Gutschrift, Auszahlung, Rückerstattung und finanziellen Abstimmung.
Einzahlung
Erstellung und Gutschrift
Auszahlung
Prüfung und Versand
Status
Bestätigung der Operation
Abstimmung
Finanzkontrolle
Zahlungsablauf
Von der Anfrage bis zum Endergebnis
01
Operation erstellen
Spieler, Betrag, Währung, Zahlungsmethode und eindeutige Operationsnummer erfassen.
02
Zahlung bestätigen
Den Spieler zur Zahlungsseite weiterleiten, Bankbestätigung anfordern oder die Zahlung direkt verarbeiten.
03
Finalen Status erhalten
Antwort des Zahlungsproviders prüfen und das endgültige Ergebnis der Operation bestätigen.
04
Guthaben und Buchhaltung aktualisieren
Mittel genau einmal gutschreiben oder belasten, Gebühren berücksichtigen und die Operation für die Abstimmung erfassen.
Übersicht
Jede Zahlung durchläuft kontrollierte Phasen
Die Plattform vergibt eine eigene Operationsnummer, verknüpft sie mit der Antwort des Zahlungsproviders und ändert den Finanzstatus erst nach einem bestätigten Ergebnis. Eine wiederholte Anfrage darf keine zweite Belastung oder Gutschrift erzeugen.
Klare Status
Die Operation durchläuft nur zulässige Phasen und ändert ein abgeschlossenes Ergebnis nicht ohne separate Korrektur.
Separate Finanzbuchhaltung
Zahlungsstatus, Guthabenänderung, Gebühr und Buchungseintrag sind miteinander verknüpft, werden aber separat geprüft.
Einzahlungsablauf
Typischer Einzahlungsablauf
Eine Einzahlung beginnt mit einer internen Operation und endet mit einer einmaligen Gutschrift nach Bestätigung durch den Zahlungsprovider.
01
Anfrage validieren und Operation erstellen
Die Plattform prüft Spieler, KYC, Limits, Währung, Betrag und Zahlungsmethode und vergibt anschließend eine interne Operationsnummer.
02
Zahlung an den Provider senden
Der Provider erhält Betrag, Währung, Spielerdaten, Return-URL, Benachrichtigungs-URL und erforderliche Zahlungsdetails.
03
Zahlung bestätigen
Der Spieler bestätigt die Zahlung auf einer externen Seite, über 3-D Secure oder in einer Banking-App.
04
Bestätigung erhalten und Guthaben gutschreiben
Nach Prüfung der Signatur und des finalen Status erhöht die Plattform das Spielerguthaben einmalig und schließt die Operation ab.
Auszahlung und Rückerstattung
Auszahlungen, Stornierung und Rückerstattungen
Ausgehende Operationen erfordern die Prüfung von Spieler, verfügbarem Guthaben, Risiko, Zahlungsdaten und finaler Antwort des Zahlungsproviders.
Spielerprüfung
KYC, Alter, Kontostatus, Limits, Selbstausschluss und zulässige Auszahlungsmethoden.
Risikoprüfungen
AML, Betrugsindikatoren, Umsatzbedingungen, Herkunft der Mittel und Freigabe durch den Betreiber.
Betrag reservieren
Der Betrag wird auf dem Guthaben reserviert, bis das endgültige Auszahlungsergebnis vorliegt.
An den Zahlungsprovider senden
Eine separate Auszahlungsanfrage mit eindeutiger Nummer und geprüften Empfängerdaten wird erstellt.
Auf das Ergebnis warten
Die Plattform akzeptiert Zwischenstatus und belastet den Betrag nicht erneut.
Rückerstattung
Eine Rückerstattung wird als separate Operation erstellt, die mit der ursprünglichen Zahlung und ihrem eigenen Betrag verknüpft ist.
Stornierung
Eine Stornierung ist nur vor dem unumkehrbaren Stadium möglich und ersetzt keine Rückerstattung für eine bereits abgeschlossene Operation.
Finale Abstimmung
Provider-Bericht, Auszahlungsdaten, Gebühren und Guthabenänderungen müssen dasselbe Ergebnis zeigen.
Operationsstatus
Empfohlenes Statusmodell
Interne Status normalisieren unterschiedliche Antworten von Zahlungsprovidern in ein einheitliches, klares Modell für die Plattform.
Erstellt
Die Operation wurde innerhalb der Plattform erstellt, aber noch nicht an den Provider gesendet oder von ihm angenommen.
Aktion erforderlich
Der Spieler muss die Zahlung bestätigen, Angaben eingeben oder eine Aktion bei seiner Bank ausführen.
In Verarbeitung
Der Provider hat die Operation angenommen, das Endergebnis wurde jedoch noch nicht bestätigt.
Abgeschlossen
Die Operation wurde erfolgreich abgeschlossen, danach wird das Guthaben genau einmal geändert.
Abgelehnt
Die Operation wurde mit einer gespeicherten Ablehnungsursache beendet, ohne weitere Belastung oder Gutschrift.
Nicht bestätigt
Das Operationsergebnis ist wegen Verbindungsfehler, Antwortverzögerung oder widersprüchlichen Daten unbekannt.
Ein unbekanntes Ergebnis darf nicht als Ablehnung behandelt werden
Die Zahlung kann vom Provider auch ohne rechtzeitige Antwort angenommen worden sein. Zuerst den aktuellen Status abfragen oder auf Bestätigung warten und erst dann entscheiden, ob eine weitere Operation erforderlich ist.
Zuverlässigkeit und Abstimmung
Duplikatschutz und finanzielle Abstimmung
Die Zuverlässigkeit der Zahlungs-API hängt von sicherem Verhalten bei wiederholten Anfragen, verzögerten Bestätigungen und Teilfehlern ab.
Schutz vor wiederholten Operationen
Jede Einzahlung, Auszahlung und Rückerstattung erhält eine eindeutige Nummer.
Eine wiederholte Anfrage gibt das vorhandene Ergebnis zurück und erstellt keine neue Finanzoperation.
Eine wiederholte Benachrichtigung wird anhand der Ereignisnummer und des aktuellen Zahlungsstatus geprüft.
Die Guthabenänderung ist mit der Zahlungsnummer verknüpft und wird nur einmal angewendet.
Finanzbuchhaltung und Abstimmung
Betrag, Gebühr, Nettobetrag, Währung und Provider-Referenz separat speichern.
Einen abgeschlossenen Eintrag nicht nachträglich überschreiben; eine separate Korrektur erstellen.
API-Operationen, Provider-Berichte, Guthabenänderungen und Auszahlungen abstimmen.
Jede Abweichung, ihre Ursache, den Verantwortlichen und das Ergebnis der Behebung protokollieren.
Tests
Was vor dem Start getestet werden muss
Erfolgreiche Zahlung, Ablehnung, Verbindungsverlust, wiederholte Bestätigung, unbekanntes Ergebnis, Rückerstattung und finanzielle Abstimmung testen.
Erfolgreiche Einzahlung und Auszahlung
Alle Zwischenstatus, Bestätigung, Guthabenänderung und finales Reporting.
Ablehnung der Operation
Unzureichende Mittel, ungültige Daten, überschrittenes Limit, Bankablehnung, Risikoprüfung und nicht verfügbare Zahlungsmethode.
Verbindungsverlust
Die Verbindung bricht nach dem Senden der Anfrage ab, und die Bestätigung trifft später ein oder wird separat abgefragt.
Wiederholte Anfragen
Dieselbe Operation oder Bestätigung trifft erneut ein, nachdem die Verarbeitung abgeschlossen wurde.
Rückerstattung und Stornierung
Vollständige und teilweise Rückerstattung, Stornierung vor der Verarbeitung und Verbot der Stornierung einer abgeschlossenen Operation.
Abstimmung
Betrag, Gebühr, finaler Status, Guthaben und Provider-Bericht stimmen nach allen Szenarien überein.
Checkliste vor dem Start
Produktivzahlungen werden aktiviert, nachdem Status, Bestätigungen, Duplikatschutz, Guthaben und Finanzreporting geprüft wurden.
Test- und Produktivumgebung verwenden unterschiedliche Zugangsdaten, Benachrichtigungs-Endpunkte und Konten.
Die Rückkehr des Nutzers zur Website wird nicht als Nachweis einer erfolgreichen Zahlung verwendet.
Signatur und Ereignisnummer werden vor der Guthabenänderung geprüft.
Einzahlungen, Auszahlungen und Rückerstattungen sind gegen wiederholte Ausführung geschützt.
Ein unbekannter Status wird mit dem Provider geklärt und bei der Abstimmung geprüft.
Fehlerwarnungen, PSP-Berichte und ein Prozess zur Untersuchung von Abweichungen sind eingerichtet.
Zahlungsablauf entwerfen?
Senden Sie uns die PSP-Liste, Zahlungsmethoden, Währungen, Märkte, Guthabenregeln und Status. APIACE hilft, Einzahlungen, Auszahlungen, Rückerstattungen, Bestätigung und finanzielle Abstimmung zu strukturieren.