Como usar o verificador de hash de postback
Cole a URL completa do postback do log do seu servidor, e o verificador preenche o ID da transação, o ID do usuário, a recompensa, o status e o hash quando seus parâmetros usam nomes comuns. Caso contrário, digite os quatro valores você mesmo. Adicione sua chave secreta do postback (Postback secret key) do painel, em Offerwalls, seu offerwall, Integration, e o verificador mostra a string exata que é assinada, o hash que você deveria obter e se ele corresponde. Nada sai do seu navegador.
Como o hash do postback é gerado
string = transaction_id:user_id:reward:status
hash = HMAC-SHA256(string, postback_secret_key), as lowercase hex
Use os quatro valores exatamente como chegam. A recompensa é enviada sem zeros à direita, por exemplo 1500 ou 0.5. A documentação de postback mostra a verificação em PHP, Node.js e Python, com uma comparação em tempo constante.
Por que um hash de postback não corresponde
- Chave errada. A chave secreta do postback não é o salt de hash do link. São dois segredos diferentes.
- Recompensa reformatada. Converter a recompensa em número e imprimi-la de novo transforma
1500em1500.00ou1500.0. Gere o hash da string original. - Ordem ou separador errado. A ordem é ID da transação, ID do usuário, recompensa, status, separados por um único sinal de dois-pontos.
- Codificação. Use os valores já decodificados da URL que o seu framework fornece, não a query string bruta.
- Hex em maiúsculas. O hash vem em minúsculas. Compare-o como ele chega.
Quando o hash corresponder, credite cada transação uma única vez: como evitar créditos duplicados. Para enviar a si mesmo um postback assinado real, use Send a test postback na aba Integration do seu app.
Perguntas frequentes
Quais valores entram no hash do postback da Moonetix?
O ID da transação, o ID do usuário, a recompensa e o status, unidos por dois-pontos e assinados com HMAC-SHA256 e a sua chave secreta do postback.
O postback de estorno é assinado da mesma forma?
Sim. Um estorno tem status 2 e o mesmo ID de transação do crédito, e o hash dele é gerado da mesma forma.
Por que meu código falha se neste verificador o hash corresponde?
O seu código altera um dos valores antes de gerar o hash, geralmente o formato da recompensa ou a chave. Imprima a string exata que o seu código assina e compare com a mostrada aqui.
É seguro colar minha chave secreta?
A página nunca a envia para lugar nenhum, mas use um app de teste ou troque a chave depois, se tiver dúvida.