Google-Standardzahlungen: Kreditkartenzahlung

Überblick

Die Card FOP (Form of Payment) API unterstützt Zahlungen mit Standardkarten. Hierbei kann es sich um Kredit- oder Debitkarten handeln. Für Zahlungen wird ein Fluss mit einer und zwei Nachrichten angeboten.

Wichtige Konzepte

Symbole und Konventionen

Die Schlüsselwörter "Muss", "DARF NICHT", "ERFORDERLICH", "SOLLTE", "WIRD NICHT", "SOLLTE", "SOLLTE NICHT", "EMPFOHLEN", "KÖNNEN" und "OPTIONAL" in diesen Dokumenten gemäß RFC 2119 interpretiert werden.

Zeitstempel

Alle Zeitstempel werden in Millisekunden seit der Unix-Epoche in UTC angegeben.

Beispiel:

  • 14. August 2010 16:30:00.00 Uhr GMT = 1281803400000
  • 6. November 2007 9:37:00 MST = 1194410220000

Beträge

Geldwerte werden in dieser API mithilfe eines Formats namens „micros“ dargestellt, einem Standard von Google. Mikros sind ein ganzzahliges Format mit fester Genauigkeit. Wenn Sie einen Geldwert in Mikroeinheiten darstellen möchten, multiplizieren Sie den Wert der Standardwährung mit 1.000.000.

Beispiel:

  • 1,23 US-Dollar = 1230000 Mikro-USD
  • 0,01 Euro = 10.000 Mikro-USD

Idempotenz

Alle Methodenaufrufe innerhalb dieser API müssen ein idempotentes Verhalten haben. Einfach ausgedrückt: Integratoren sollten nicht versuchen, bereits erfolgreich verarbeitete Anfragen noch einmal zu verarbeiten. Stattdessen sollte die Antwort für die erfolgreiche Verarbeitung gemeldet werden. Alle Methoden haben einen gemeinsamen RequestHeader, der eine requestId enthält. Diese requestId ist der Idempotenzschlüssel für alle Aufrufe.

Nicht-Terminal-Antworten (Nicht-HTTP 200-Antworten) dürfen nicht idempotent verarbeitet werden. Eine Anfrage, die zuvor einen 400-Fehler erhalten hat und beim zweiten Aufruf nicht idempotent 400 zurückgeben darf, muss also neu bewertet werden. Bei der Neubewertung könnte sie den Fehler 400 zurückgeben oder erfolgreich verarbeitet werden.

Weitere Informationen zur Idempotenz finden Sie in dieser ausführlichen Anleitung.

Erfassungsfluss reservieren

Der Ablauf der Reservierungserfassung ist ein zwei Nachrichtenfluss, bei dem zuerst Geldmittel reserviert und dann später erfasst werden. Während der Reservierung findet keine Geldbewegung statt. Die Reservierung kann dann storniert oder erfasst werden. Das Endergebnis der Erfassung oder des Abbruchs wird asynchron über eine Benachrichtigung an Google zurückgegeben.

Der Zahlungsintegrator implementiert

Google implementiert

Weitere Informationen zur Erfassung von Reserven finden Sie in dieser ausführlichen Anleitung.

Überweisungsablauf

Der Zahlungsfluss ist ein einzelner Nachrichtenfluss, bei dem Geld direkt erfasst wird. Der Ablauf besteht aus einer einzigen Methode, die vom Zahlungsintegrator Capture implementiert wird. Bei dieser Methode wird synchron auf verfügbare Mittel geprüft und im Erfolgsfall erfasst.

Der Zahlungsintegrator implementiert

Google implementiert

Weitere Informationen zu Geldtransfers finden Sie in dieser detaillierten Anleitung.

Erstattungsablauf

Über den Erstattungsablauf werden Beträge zurückgegeben, die zuvor über die Reservierungserfassung oder Überweisung eingegangen sind.

Der Zahlungsintegrator implementiert

Google implementiert

Weitere Informationen zu Erstattungen findest du in dieser detaillierten Anleitung.

Einspruchsverfahren

Das Einspruchsverfahren wird verwendet, um Google über Anfechtungen und Rückbuchungen zu informieren, bei denen der Kunde eine Erstattung beantragt. Nicht jeder Aufruf impliziert eine Geldbewegung. Dieser Vorgang kann jedoch verwendet werden, um Geldmittel an einen Kunden zurückzuüberweisen oder diesen Vorgang rückgängig zu machen und ihn an Google zurückzusenden. Dieser Vorgang kann zusätzlich zum Ablauf der Betrugsmeldung verwendet werden, umfasst aber nicht zwingend Betrug.

Google implementiert

Weitere Informationen zu Einsprüchen findest du in dieser detaillierten Anleitung.

Ablauf der Betrugsmeldung

Das Verfahren zum Melden von Betrug dient dazu, Google über potenziellen Betrug zu informieren. Diese Informationen implizieren keine Geldbewegungen und werden lediglich verwendet, um die Risk Engine von Google über das Ereignis zu informieren, sodass der Betrug insgesamt reduziert werden kann. Dies kann mit einer Anfechtung oder Rückbuchung während des Einspruchsverfahrens verbunden sein.

Google implementiert

Weitere Informationen zum Melden von Betrugsversuchen finden Sie in diesem detaillierten Leitfaden.