Les intégrateurs doivent mettre en œuvre un hôte Web pour rediriger les utilisateurs à des fins de réapprovisionnement. Cette recharge de crédit est une modalité différente, mais le même objectif est que celui fourni par les recharges Android. Cet hôte Web doit disposer d'un site Web adapté aux mobiles.
L'hôte Web doit distinguer les requêtes Web mobiles de celles pour ordinateur en fonction de la valeur de l'en-tête du user-agent. La page affichée dans les requêtes Web mobile doit être adaptée au Web mobile sur Android et iOS. Outre la valeur de l'en-tête user-agent, le client ne vous fournit aucune autre indication sur l'environnement dans lequel l'utilisateur effectue la requête (ordinateur ou Web).
Le serveur doit mettre en œuvre un protocole HTTPS à l'aide de GET. Le chemin d'accès et l'hôte peuvent être définis par l'intégrateur. L'intégrateur doit accepter des URL de 2 048 caractères. Cela inclut le schéma, l'hôte, le port, le chemin d'accès et les paramètres.
Tous les paramètres seront encodés en UTF-8 avant d'être encodés en URL.
Requête
À la demande, Google fournit les éléments suivants en tant que paramètres d'URL:
| Champs | |
|---|---|
gspMajorVersion
|
int
Numéro de version majeure pour cette requête. |
gspTopUpRequest
|
TopUpRedirectRequest
Demande de recharge de crédit. |
gspAssociationId
|
string
Contient un identifiant que l'intégrateur utilise pour rechercher les identifiants du compte que l'utilisateur complète. Il s'agit de l'ID d'association envoyé lors de l'association de comptes dans la demande AssociateAccountRequest. |
gspCallbackUrl
|
string
URL vers laquelle rediriger l'utilisateur pour terminer le processus de rechargement sur Google. Cette valeur est encodée au format URL. |
Réponse
Une fois la recharge de crédit terminée, l'utilisateur doit être redirigé vers gspCallbackUrl à l'aide de HTTPS GET. Cette URL doit comporter les paramètres de requête suivants:
| Champs | |||||||
|---|---|---|---|---|---|---|---|
gspResult
|
int
|
||||||
| redirectRequestId |
string OBLIGATOIRE: requestId envoyé dans la demande de paiement de redirection initiale ou qui a initié la demande. Google vérifiera qu'il s'agit du requestId envoyé. Sinon, le flux "Complete Redirect" échouera.
|
||||||
gspTopUpResponse |
OBLIGATOIRE: TopUpRedirectResponse doit être chiffré et signé à l'aide de PGP ou de JWE+JWS. De plus, cette valeur doit être encodée au format base64 adapté au Web. |
||||||