Gli integratori devono implementare un host web per reindirizzare gli utenti ai fini della ricarica. Questa ricarica è una modalità diversa, ma ha lo stesso scopo di quella fornita da Ricariche Android. Questo host web deve avere un sito web ottimizzato per i dispositivi mobili.
L'host web deve determinare le richieste di web mobile rispetto a quelle web desktop in base al valore dell'intestazione user-agent. La pagina pubblicata nelle richieste web mobile deve essere ottimizzata per il web mobile su Android e iOS. Oltre al valore dell'intestazione dello user agent, il client non fornirà altri indizi sull'ambiente in cui l'utente esegue la richiesta (desktop o web).
Il server deve implementare un protocollo HTTPS utilizzando GET. Percorso e host sono definibili dall'integratore. L'integratore deve supportare lunghezze degli URL di 2048 caratteri. Sono inclusi schema, host, porta, percorso e parametri.
Tutti i parametri utilizzano la codifica UTF-8 prima di essere codificati nell'URL.
Richiesta
Su richiesta, Google fornisce i seguenti parametri URL:
| Campi | |
|---|---|
gspMajorVersion
|
int
Numero di versione principale di questa richiesta. |
gspTopUpRequest
|
TopUpRedirectRequest
Richiesta di ricarica. |
gspAssociationId
|
string
Contiene un identificatore che l'integratore utilizza per cercare le credenziali dell'account che l'utente sta ricaricando. Questo è l'ID associazione che viene inviato durante il collegamento dell'account in AssociateAccountRequest. |
gspCallbackUrl
|
string
URL a cui reindirizzare l'utente per completare il flusso di ricarica su Google. Questo valore è codificato nell'URL. |
Risposta
Al termine della ricarica, l'utente deve essere reindirizzato a gspCallbackUrl utilizzando HTTPS GET. Questo URL deve avere i seguenti
parametri di query:
| Campi | |||||||
|---|---|---|---|---|---|---|---|
gspResult
|
int
|
||||||
| redirectRequestId |
string OBBLIGATORIO: il valore requestId inviato nella richiesta di pagamento di reindirizzamento originale o che ha avviato la richiesta. Google verificherà che questo corrisponda a quello dell'requestId inviato e il flusso di reindirizzamento completo avrà esito negativo se non corrisponde.
|
||||||
gspTopUpResponse |
OBBLIGATORIO: il TopUpRedirectResponse deve essere criptato e firmato utilizzando PGP o JWE+JWS. Inoltre, questo valore deve essere codificato in base64 sicuro per il web. |
||||||