Как пользоваться проверкой хеша postback
Вставьте полный URL postback из лога сервера, и инструмент заполнит ID транзакции, ID пользователя, награду, статус и хеш, если ваши параметры названы привычным образом. Иначе введите четыре значения сами. Добавьте секретный ключ postback из личного кабинета, раздел Offerwall, ваш offerwall, Интеграция, и инструмент покажет точную подписываемую строку, хеш, который должен получиться, и совпадает ли он. Ничего не покидает ваш браузер.
Как строится хеш postback
string = transaction_id:user_id:reward:status
hash = HMAC-SHA256(string, postback_secret_key), as lowercase hex
Используйте четыре значения ровно в том виде, в каком они приходят. Награда отправляется без нулей в конце, например 1500 или 0.5. Документация по postback показывает проверку на PHP, Node.js и Python со сравнением за постоянное время.
Почему хеш postback не совпадает
- Неверный ключ. Секретный ключ postback - это не соль для хеша ссылок. Это два разных секрета.
- Переформатированная награда. Если преобразовать награду в число и снова вывести ее,
1500превратится в1500.00или1500.0. Хешируйте исходную строку. - Неверный порядок или разделитель. Порядок такой: ID транзакции, ID пользователя, награда, статус, разделенные одиночными двоеточиями.
- Кодирование. Используйте декодированные из URL значения, которые дает ваш фреймворк, а не исходную строку запроса.
- Hex в верхнем регистре. Хеш приходит в нижнем регистре. Сравнивайте его в том виде, в каком он пришел.
Когда хеш совпадает, начисляйте каждую транзакцию один раз: как избежать двойных начислений. Чтобы отправить себе настоящий подписанный postback, используйте "Отправить тестовый postback" на вкладке "Интеграция" вашего приложения.
Частые вопросы
Какие значения входят в хеш postback от Moonetix?
ID транзакции, ID пользователя, награда и статус, соединенные двоеточиями и подписанные HMAC-SHA256 с вашим секретным ключом postback.
Подписывается ли postback отмены так же?
Да. Отмена имеет статус 2 и тот же ID транзакции, что и начисление, а ее хеш строится так же.
Почему мой код не проходит проверку, а здесь хеш совпадает?
Ваш код меняет одно из значений перед хешированием, обычно формат награды или ключ. Выведите точную строку, которую подписывает ваш код, и сравните ее с показанной здесь.
Безопасно ли вставлять сюда мой секретный ключ?
Страница никуда его не отправляет, но если сомневаетесь, используйте тестовое приложение или смените ключ после проверки.