Integratoren müssen einen Webhost implementieren, um die Nutzer zu Aufladezwecken weiterzuleiten. Diese Aufladung ist eine andere Modalität, aber derselbe Zweck wie die Aufladung durch Android-Aufladungen. Dieser Webhost muss eine für Mobilgeräte optimierte Website haben.
Der Webhost muss Anfragen im mobilen Web und Desktop-Webanfragen anhand des User-Agent-Header-Werts bestimmen. Die Seite, die bei Anfragen für das mobile Web bereitgestellt wird, muss für das mobile Web unter Android und iOS optimiert sein. Abgesehen vom User-Agent-Header-Wert gibt der Client Ihnen keinen weiteren Hinweis auf die Umgebung, in der dieser Nutzer die Anfrage stellt (Desktop oder Web).
Auf dem Server muss ein HTTPS-Protokoll mit GET implementiert werden. Pfad und Host können vom Integrator definiert werden. 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 der URL-Codierung in UTF-8 codiert.
Anfragen
Auf Anfrage stellt Google Folgendes als URL-Parameter zur Verfügung:
| Felder | |
|---|---|
gspMajorVersion
|
int
Hauptversionsnummer für diese Anfrage. |
gspTopUpRequest
|
TopUpRedirectRequest
Aufladeanfrage |
gspAssociationId
|
string
Enthält eine Kennung, mit der der Integrator Anmeldedaten für das Konto abruft, das der Nutzer auflädt. Das ist die Verknüpfungs-ID, die während der Kontoverknüpfung in der AssociateAccountRequest-Anfrage gesendet wird. |
gspCallbackUrl
|
string
URL, an die der Nutzer weitergeleitet werden soll, um den Aufladevorgang auf Google abzuschließen. Dieser Wert ist URL-codiert. |
Antwort
Nach Abschluss des Aufladens muss der Nutzer mit HTTPS GET zu gspCallbackUrl weitergeleitet werden. Diese URL muss die folgenden Abfrageparameter haben:
| Felder | |||||||
|---|---|---|---|---|---|---|---|
gspResult
|
int
|
||||||
| redirectRequestId |
string REQUIRED: requestId, der in der ursprünglichen/initiierenden Zahlungsweiterleitungsanforderung gesendet wurde. Google überprüft, ob dies mit dem gesendeten requestId übereinstimmt. Wenn dies nicht der Fall ist, schlägt der Vorgang für die vollständige Weiterleitung fehl.
|
||||||
gspTopUpResponse |
ERFORDERLICH: Die TopUpRedirectResponse muss mit PGP oder JWE+JWS verschlüsselt und signiert sein. Außerdem sollte dieser Wert websicher mit base64 codiert sein. |
||||||