Cómo usar el verificador de hash de postback
Pegue la URL completa del postback desde el registro de su servidor, y el verificador completa el ID de transacción, el ID de usuario, la recompensa, el estado y el hash cuando sus parámetros usan nombres comunes. Si no, escriba usted mismo los cuatro valores. Agregue su postback secret key desde su panel, en Offerwalls, su offerwall, Integration, y el verificador muestra la cadena exacta que se firma, el hash que debería obtener y si coincide. Nada sale de su navegador.
Cómo se construye el hash del postback
string = transaction_id:user_id:reward:status
hash = HMAC-SHA256(string, postback_secret_key), as lowercase hex
Use los cuatro valores exactamente como llegan. La recompensa se envía sin ceros finales, por ejemplo 1500 o 0.5. La documentación de postbacks muestra la comprobación en PHP, Node.js y Python, con una comparación de tiempo constante.
Por qué no coincide el hash de un postback
- Clave incorrecta. La postback secret key no es el link hash salt. Son dos secretos distintos.
- Recompensa reformateada. Convertir la recompensa en número y volver a imprimirla transforma
1500en1500.00o1500.0. Calcule el hash de la cadena original. - Orden o separador incorrectos. El orden es ID de transacción, ID de usuario, recompensa, estado, unidos con dos puntos simples.
- Codificación. Use los valores decodificados de URL que le entrega su framework, no la cadena de consulta sin procesar.
- Hex en mayúsculas. El hash está en minúsculas. Compárelo tal como llega.
Cuando el hash coincida, acredite cada transacción una sola vez: cómo evitar acreditaciones duplicadas. Para enviarse un postback firmado real, use Send a test postback en la pestaña Integration de su app.
Preguntas frecuentes
¿Qué valores incluye el hash del postback de Moonetix?
El ID de transacción, el ID de usuario, la recompensa y el estado, unidos con dos puntos, firmados con HMAC-SHA256 y su postback secret key.
¿El postback de reversión se firma de la misma manera?
Sí. Una reversión tiene el estado 2 y el mismo ID de transacción que la acreditación, y su hash se construye de la misma manera.
¿Por qué falla mi código si este verificador coincide?
Su código cambia uno de los valores antes de calcular el hash, normalmente el formato de la recompensa o la clave. Imprima la cadena exacta que firma su código y compárela con la que se muestra aquí.
¿Es seguro pegar mi clave secreta?
La página nunca la envía a ningún lugar, pero use una app de prueba o rote la clave después si tiene dudas.