Weiterleitungszahlungen können auf zwei verschiedene Arten veranlasst werden:
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.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 |
redirectRequest
|
RedirectRequest
ERFORDERLICH: Der |