Configurar descontos automáticos

Siga estas instruções para implementar o token de preço.

Estrutura de tokens

Os tokens JWT contêm dois objetos JSON: cabeçalho e payload.

Cabeçalho

{

"alg": "ES256",

"typ": "JWT"

}

Os cabeçalhos de token gerados pelo Google têm dois campos:

• alg: algoritmo usado; o valor sempre será "ES256".
• typ: tipo de mídia; o valor sempre será "JWT".

Se o cabeçalho do token tiver outros campos ou os valores do campo forem diferentes do descrito acima, o token precisará ser recusado.

Payload

{
"exp": 1571673600,
"o": "tddy123uk",
"m": "140301646",
"p": 21.99,
"pp": 15.00,
"c": "USD"
}

O payload tem os seguintes campos:

• exp: o prazo de validade no formato de horário Unix. Se o token tiver expirado, será preciso recusá-lo.
• o: ID da oferta, que é usado para verificar se a página de destino corresponde ao produto ou a uma variante válida. Se não corresponder, a página será rejeitada. Uma variante válida pode ser, por exemplo, o mesmo calçado em números diferentes.
• m: ID do comerciante. Se o ID do comerciante não for correspondente, o token terá que ser recusado.
• p: preço dos descontos automáticos do Google (GAD, na sigla em inglês).
• pp: preço anterior*
  Para o EEE: o preço anterior também será enviado no URL se aparecer no anúncio do Shopping. Você pode apresentar o preço anterior na sua loja on-line, representando o menor preço exibido aos usuários no Google nos últimos 30 dias nos seguintes países: Croácia, Espanha, Letônia, Noruega, Polônia. Para os outros países do EEE, o preço anterior reflete o valor antes da aplicação de reduções consecutivas nos últimos 60 dias.
• c: moeda, em letra maiúscula.

Como aplicar o token

Os detalhes exatos sobre como aplicar o token dependem da biblioteca usada, mas há três etapas em um nível elevado: decodificação e validação de assinatura, validação de campo e aplicação de preço.

Decodificação e validação de assinatura O token codificado em Base64URL é transmitido no parâmetro de solicitação de URL pv2:

A maioria das bibliotecas combina a decodificação e a validação da assinatura para uma única função, em que "token", "ES256" (algoritmo) e "chave pública" são entradas e "token_body" é a resposta:

Chave pública para validação:

A chave a seguir deve ser usada por todos os usuários de descontos automáticos sem expiração.

Validação de campo

Caso a biblioteca selecionada aceite a chave e o algoritmo na etapa anterior e force o uso mesmo com as opções do cabeçalho, não haverá necessidade de outras verificações de cabeçalho. Caso contrário, será preciso verificar os campos do cabeçalho de acordo com as diretrizes acima. Para mais informações, consulte as práticas recomendadas atuais de JSON Web Tokens (em inglês).

Independentemente da biblioteca usada, será necessário validar os campos o, m e p nos dados do comerciante. Se eles não corresponderem, o token precisará ser rejeitado para que os clientes não possam copiar tokens em produtos e/ou comerciantes. O comerciante pode verificar o campo exp e recusar o token se ele tiver expirado, mas isso não é obrigatório.

Preço de consumo Se todos os campos forem válidos e o token não tiver expirado, o comerciante terá que usar o preço informado no campo p.

Use o recurso de cupons para aplicar descontos nos preços caso isso esteja de acordo com os requisitos explicados nesta página. Especificamente, o preço na página de destino deve ser igual ao preço no token. Não basta adicionar o desconto na página de finalização da compra.

Testes Depois que a integração for concluída, ela vai passar por um teste em três etapas:

• Teste funcional (feito pelo comerciante)
• Validação da chave (feita pelo comerciante com o token fornecido pelo Google)
• Teste completo de todo o processo (feito pelo Google)

Teste funcional A forma mais fácil de realizar testes durante e depois do desenvolvimento é gerar um par de chaves temporário, que dá a você controle total sobre os tokens. Um par válido pode ser gerado com este comando:

Os tokens podem ser gerados com jwt.io ou ferramentas semelhantes, usando o ES256 como algoritmo.

Validação de chave Os tokens assinados estão disponíveis no Merchant Center durante as integrações (URLs de exemplo) para confirmar que as chaves de produção estão configuradas corretamente.