Os integradores precisam implementar um host da Web para redirecionar os usuários para fins de recarga. Essa recarga é uma modalidade diferente, mas com a mesma finalidade fornecida pelas Recargas do Android. Este host da Web precisa ter um site compatível com dispositivos móveis.
O host da Web precisa determinar as solicitações da Web para dispositivos móveis em comparação com as solicitações da Web para computadores com base no valor do cabeçalho do user agent. A página entregue nas solicitações da Web para dispositivos móveis precisa ser compatível com a Web para dispositivos móveis no Android e no iOS. Além do valor do cabeçalho do user agent, o cliente não fornecerá outra dica sobre o ambiente em que o usuário está fazendo a solicitação (computador ou Web).
O servidor precisa implementar um protocolo HTTPS usando GET. O caminho e o host são definíveis pelo integrador. O integrador precisa oferecer suporte a comprimentos de URL de 2.048 caracteres. Isso inclui o esquema, o host, a porta, o caminho e os parâmetros.
Todos os parâmetros serão codificados em UTF-8 antes de serem codificados para URL.
Solicitação
Mediante solicitação, o Google fornece os seguintes parâmetros de URL:
| Campos | |
|---|---|
gspMajorVersion
|
int
Número da versão principal da solicitação. |
gspTopUpRequest
|
TopUpRedirectRequest
Solicitação de recarga. |
gspAssociationId
|
string
Contém um identificador que o integrador usa para procurar as credenciais da conta que o usuário está atualizando. Esse é o ID da associação enviado durante a vinculação da conta na AssociateAccountRequest. |
gspCallbackUrl
|
string
URL para redirecionar o usuário para concluir o fluxo de recarga no Google. Esse valor é codificado por URL. |
Resposta
Após a conclusão da recarga, o usuário precisa ser redirecionado para
gspCallbackUrl usando HTTPS GET. Esse URL precisa ter os seguintes parâmetros de consulta:
| Campos | |||||||
|---|---|---|---|---|---|---|---|
gspResult
|
int
|
||||||
| redirectRequestId |
string OBRIGATÓRIO: o requestId enviado na solicitação de pagamento de redirecionamento original/iniciando. O Google vai verificar se essa correspondência corresponde ao requestId enviado, e o fluxo de redirecionamento completo falhará se não corresponder.
|
||||||
gspTopUpResponse |
OBRIGATÓRIO: o TopUpRedirectResponse precisa ser criptografado e assinado usando PGP ou JWE+JWS. Além disso, esse valor precisa ser codificado em base64, otimizado para a Web. |
||||||