Google-Standardzahlungen:

Zahlungsmethode weiterleiten

Überblick

Google Standard Payments unterstützt Weiterleitungs-basierte Zahlungsweisen. Ein Weiterleitungs-FOP ermöglicht es Nutzern von Google-Produkten oder -Diensten, diese auf der Weboberfläche einer externen Entität zu bezahlen. Grundsätzlich wird ein Nutzer, der Waren bezahlen möchte, zuerst an einen Zahlungsintegrator oder einen Aussteller weitergeleitet, der über einen Zahlungsintegrator verfügbar ist. Wenn der Nutzer zum Integrator weitergeleitet wird, muss der Integrator den Nutzer an die Weboberfläche des Ausstellers weiterleiten, um den Kauf abzuschließen. Sobald die Zahlung abgeschlossen ist, sollte der Nutzer über den Integrator wieder zu Google zurückgeleitet werden.

Google nutzt zwei Hauptabläufe für die Weiterleitung von Zahlungsmitteln:

  1. Weiterleitung einleiten: Es gibt zwei verschiedene Abläufe, die eine Weiterleitung zur Zahlung initiieren können. Der Zahlungsintegrator sollte nur eine der folgenden Optionen implementieren:
  2. Weiterleitungsvorgang abschließen: Sobald der Nutzer den Kauf abgeschlossen hat, verwendet der Integrationspartner diesen Vorgang, um die Zahlung mit Google zu bestätigen.

Zu guter Letzt erfolgt die gesamte Überweisung zwischen der Bank des Integrators und der Bank von Google im Rahmen des Überweisungsverfahrens.

Weiterleitungs-Zahlungsweise – Übersicht

Die folgende Abbildung zeigt einen allgemeinen Überblick über die Abläufe:

Übersichtsdiagramm zum Zahlungsmittel für Weiterleitungen

Das Hinzufügen Ihres Dienstes als Zahlungsmittel zu Google-Produkten umfasst folgende Abläufe:

  1. Weiterleitung initiieren:
  2. Ablauf einer Weiterleitung
  3. Erstattungsablauf
  4. Zahlungsfluss

Konzepte und Begriffe

Symbole und Konventionen

Die Schlüsselwörter „Muss“, „DARF NICHT“, „ERFORDERLICH“, „GESCHENKT“, „SOLLTE NICHT“, „SOLLTE“, „SOLLTE NICHT“, „EMPFOHLEN“, „KÖNNEN“ und „OPTIONAL“ in diesen Dokumenten wie in RFC 2119 beschrieben interpretiert werden.

Zeitstempel

Alle Zeitstempel werden in Millisekunden seit der Unix-Epoche (1. Januar 1970) in UTC angegeben.

Beispiel:

  • 23. April 2019, 20:23:25 Uhr GMT = 1556051005000 Millisekunden
  • 16. August 2018, 12:28:35 Uhr GMT = 1534422515000 Millisekunden

Beträge

Geldwerte in diesem API liegen in einem Format vor, das als „micros“ bezeichnet wird und einem Standard von Google entspricht. Mikros sind ein ganzzahliges Format mit fester Genauigkeit. Wenn Sie einen Geldwert in Mikroeinheiten darstellen möchten, multiplizieren Sie die 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. Google wiederholt sporadisch Anfragen, um sicherzustellen, dass sich die Transaktionen auf beiden Seiten im selben Status befinden. Integratoren sollten nicht versuchen, bereits erfolgreich verarbeitete Anfragen noch einmal zu verarbeiten. Stattdessen sollte die Antwort für die erfolgreiche Verarbeitung zurückgegeben werden. Alle Methoden haben eine gemeinsame RequestHeader, die eine requestId enthält. Diese requestId ist der Idempotenzschlüssel für alle Aufrufe.

Jede Nicht-Terminal-Antwort (kein HTTP 200-Erfolg) darf nicht idempotent verarbeitet werden. Eine Anfrage, die zuvor einen 400-Fehler erhalten hat (ungültige Anfrage/fehlgeschlagene Voraussetzung), wenn sie ein zweites Mal aufgerufen wird, darf nicht idempotent 400 zurückgeben und muss neu ausgewertet werden. Bei der Neubewertung wird möglicherweise ein 400-Fehler zurückgegeben oder die Verarbeitung war erfolgreich.

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

Integrator

Unternehmen, die die Zahlungsplattform von Google für ihr Geschäft nutzen. Es kann sich um interne Unternehmen wie YouTube oder AdWords handeln, aber auch um externe Unternehmen, die ihren Dienst in die Google-Plattform integrieren möchten.

Zahlungsmittel

Zahlungsart. Dies ist allgemeiner gehalten als ein Instrument. Visa, MasterCard und PayPal sind Zahlungsmittel.

Zahlungsmittel

Eine bestimmte Instanz eines Zahlungsmittels eines bestimmten Kunden. Zum Beispiel die Kreditkarte eines Nutzers oder sein PayPal-Konto. Ein tokenisiertes Zahlungsmittel für einen bestimmten Kunden ist ebenfalls ein Zahlungsmittel, da es eine Instanz eines Zahlungsmittels für diesen Kunden ist und sicher in unserem System gespeichert wird.

Token

Darstellung der Zahlungsmethode eines bestimmten Nutzers im Google-System. Da sie alle für einen Kauf erforderlichen Informationen enthält, ist ein Token auch ein Zahlungsmittel. Dazu können beispielsweise Informationen wie eine Kontonummer gehören, die ein Nutzer bei seinem Integrator hat.

Wichtige Abläufe

Weiterleitung starten

Der erste Schritt bei einer Weiterleitungszahlung ist der Ablauf „Weiterleitung beginnen“. Mit dem Ablauf Weiterleitung beginnen wird der Nutzer über den Integrator zur Weboberfläche des ausgewählten Ausstellers weitergeleitet, damit er eine Zahlung autorisieren kann. Bei der Weiterleitung stellt Google dem Integrator grundlegende Transaktionsinformationen zur Verfügung, die diese wiederum an den Aussteller weiterleiten.

Weitere Informationen finden Sie im Abschnitt Weiterleitung starten.

Weiterleitung

Sobald sich der Nutzer auf der Weboberfläche des Ausstellers befindet, sollte er alle erforderlichen Schritte ausführen, um eine Zahlung abzuschließen. Diese Schritte können je nach Aussteller variieren. Im Rahmen des Vorgangs für die vollständige Weiterleitung muss der Aussteller den Nutzer mit Informationen über die erfolgreiche Zahlung zurück zum Integrator weiterleiten. Der Integrator leitet den Nutzer wiederum zurück zu Google, einschließlich der Zahlungsdetails als Teil der Weiterleitungsantwort. Sobald die Zahlung bestätigt wurde, stellt Google dem Nutzer die gekauften Waren oder Dienstleistungen bereit.

Weitere Informationen finden Sie im Abschnitt Ablauf der Weiterleitung.