Weiterleitungsfluss starten

Weiterleitungszahlungen können auf zwei verschiedene Arten veranlasst werden:

  1. Wenn der Nutzer „Zahlung weiterleiten“ auswählt, wird er zur Website des Integrationspartners weitergeleitet, um das zu verwendende Zahlungsmittel auszuwählen. In diesem Fall wird noFopChosen in der Anfrage ausgefüllt. In diesem Fall zeigt der Integrator dem Nutzer eine Liste der verfügbaren Aussteller an. Sobald der Nutzer eine dieser Optionen ausgewählt hat, wird er zur Website/App dieses Ausstellers weitergeleitet, um den Kauf abzuschließen.

  2. Der Nutzer wählt während des Kaufvorgangs ein Zahlungsmittel aus. In diesem Fall füllt Google den Parameter issuerId in der Anfrage aus und leitet den Nutzer an den Integrator weiter. Wenn der Integrationspartner diese erhält, sollte er den Nutzer sofort zur Website/App des Ausstellers weiterleiten, um den Kauf abzuschließen.

In beiden oben genannten Fällen leitet Google den Nutzer ohne vorherigen Server-zu-Server-Aufruf von Google direkt zur Website des Integrationspartners weiter.

Der Integrator muss ein HTTPS-Protokoll mit GET implementieren. Die unter Parameter für Weiterleitungsanfragen beschriebenen GET-Parameter enthalten Informationen zur angeforderten Weiterleitungszahlung.

Der Integrator muss URL-Längen von 2.048 Zeichen unterstützen. Dazu gehören Schema, Host, Port, Pfad und Parameter. Alle Parameter werden vor ihrer URL-Codierung in UTF-8 codiert.

Anfrage weiterleiten

Hier ist ein Beispiel für die URL, zu der der Nutzer im Rahmen des Vorgangs zum Starten der Weiterleitung (auch als Weiterleitungsanfrage bezeichnet) weitergeleitet wird:

https://www.integratordomain.com/example/redirectEndpoint?callbackUrl=https%3A%2F%2Fexample.google.com%2Freturn%2Furl%3FredirectRequestId%3DcmVxdWVzdDE&redirectRequest=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVRVUVTVF9QQVlMT0FEX0VYQU1QTEVfVEhBVF9JU19FTkNPREVEX1dJVEhfYmFzZTY0X1VSTC1TQUZFX0VOQ09ESU5H

Der URL-decodierte Wert des Parameters callbackUrl in diesem Beispiel lautet:

https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE

Der Parameter redirectRequest wird mit PGP oder JWE+JWS verschlüsselt und signiert, bevor er mit base64url codiert wird.

Parameter für Weiterleitungsanfragen

Die HTTPS-GET-Anfrage muss die folgenden Abfrageparameter enthalten:

Felder
callbackUrl string

URL, an die der Nutzer weitergeleitet werden soll, wenn eine Zahlung abgeschlossen ist. Dieser Wert ist URL-codiert und hat eine maximale Länge von 512 Zeichen.

Diese URL enthält den requestId aus dem verschlüsselten redirectRequest im GET-Parameter redirectRequestId. Der Anbieter sollte überprüfen, ob die redirectRequestId aus der callbackUrl und die requestId aus der verschlüsselten Nutzlast identisch sind, um zu überprüfen, ob beide zusammenhängen.

redirectRequest RedirectRequest

ERFORDERLICH: Der RedirectRequest muss mit PGP oder JWE+JWS verschlüsselt und signiert sein. Außerdem sollte dieser Wert websicher mit base64 codiert sein.