Como usar o gerador de links de offerwall
Copie seu App ID e seu salt de hash do link (Link hash salt) do painel, em Offerwalls, no seu offerwall, aba Integration. Digite o ID de usuário de uma conta de teste, adicione sub IDs se você rastreia posicionamentos, e o gerador mostra o hash, o link assinado completo e o código pronto para colar do iframe e do botão Earn. Nada do que você digita é enviado: o hash é calculado no seu navegador com a Web Crypto API.
Use-o para verificar o código do seu próprio servidor. Se o link que o seu servidor gera para o mesmo ID de usuário não corresponder ao daqui, a diferença está no seu código, não na Moonetix.
Como o hash é gerado
hash = HMAC-SHA256(user_id, link_hash_salt), as lowercase hex
link = https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH
O ID do usuário é a mensagem e o salt é a chave. Os sub IDs não fazem parte do hash, então os usuários podem alterá-los: use-os para rastreamento, nunca para creditar. A documentação do link de offerwall mostra o mesmo código em PHP, Node.js e Python.
Mantenha o salt no seu servidor
Esta página é uma ferramenta de teste. Em produção, gere o hash no seu servidor e envie apenas o link pronto para o navegador ou o app. Um salt em JavaScript, no pacote de um app ou em um repositório público permite que qualquer pessoa abra o seu offerwall como qualquer um dos seus usuários. Se um salt vazar, troque-o: como trocar as chaves e o salt do link explica a ordem segura.
Problemas comuns
- Link inválido (403). O hash não corresponde ao ID de usuário. Verifique se você gera o hash exatamente da mesma string de ID de usuário que colocou no link, com o salt de hash do link, e não com a chave secreta do postback.
- Números vs. strings. Gere o hash do ID de usuário como string.
42e042são usuários diferentes. - Codificação. Gere o hash do ID de usuário bruto e depois aplique a codificação de URL no link. Não gere o hash do valor codificado.
Perguntas frequentes
É seguro digitar meu salt de hash do link aqui?
A página nunca o envia para lugar nenhum, mas usar um app de teste ou um salt de teste ainda é o hábito mais seguro. Nunca coloque o seu salt real em código do lado do cliente.
Qual hash o link do offerwall da Moonetix usa?
HMAC-SHA256 do ID de usuário, com o seu salt de hash do link como chave, em hex minúsculo.
Os sub IDs mudam o hash?
Não. Os sub IDs não fazem parte do hash, então você pode adicioná-los ou alterá-los sem gerar o hash de novo.
Posso usar este link em um app mobile?
Sim, em uma WebView ou no navegador do sistema, se o seu backend gerar o link. Para uma tela nativa, use o SDK para Android, iOS, Unity, Flutter ou React Native com um token de sessão.