Интеграцияпостбека

✦Шаг 1 · от нас к вам

Как к вам приходитнаш click id

https://track.your-casino.example/r/AFF123

https://track.your-casino.example/r/AFF123?sub1=9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d

• Макросы заполняем

  Если этот параметр уже есть в ссылке с макросом вроде {click_id}, [subid] или <sub>, мы заменим макрос на click id.

  https://track.your-casino.example/r/AFF123?sub1={click_id}
  → https://track.your-casino.example/r/AFF123?sub1=9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d

• Настоящее значение не трогаем

  Если в параметре уже стоит настоящее значение, обычно ваш же партнёрский тег, ссылка уходит как есть и без click id. Выберите параметр, которым не пользуется ваш партнёрский код.

  https://track.your-casino.example/r/AFF123?sub1=AFF123
  → https://track.your-casino.example/r/AFF123?sub1=AFF123

• Один переход — один id

  Каждый переход получает новый id, и игрок, кликнувший дважды, придёт с двумя. Возвращайте тот, с которым пришла регистрация, ровно в том виде, в каком получили: регистр букв имеет значение.

✦Шаг 2 · от вас к нам

Сообщите намо депозите

https://highrollers.club/api/postback

Параметры

• clickIdобязательный

  Click id, который мы дописали к вашей ссылке, как есть. От 8 до 100 символов.

• amountнеобязательный

  Сумма депозита. Для справки: сохраняем число и валюты не пересчитываем.

• revenueнеобязательный

  Ваша выплата нам за этого игрока, CPA или ревшара. По ней мы видим, какой трафик окупается.

• eventнеобязательный

  Метка до 50 символов. Принимаем и пока не используем.

• secretнеобязательный

  Только если заголовок недоступен, см. выше.

Примеры

curl -G 'https://highrollers.club/api/postback' \
  -H 'X-Postback-Secret: YOUR_SECRET' \
  --data-urlencode 'clickId=9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d' \
  --data-urlencode 'amount=2500' \
  --data-urlencode 'revenue=750'

curl -X POST 'https://highrollers.club/api/postback' \
  -H 'Content-Type: application/json' \
  -H 'X-Postback-Secret: YOUR_SECRET' \
  -d '{"clickId":"9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d","amount":2500,"revenue":750}'

https://highrollers.club/api/postback?clickId={sub1}&amount={deposit_amount}&revenue={payout}&secret=YOUR_SECRET

YOUR_SECRET и click id здесь заглушки. Подставьте секрет, который мы вам прислали, и click id настоящего перехода.

✦Что вернётся

Ответыи повторы

• 200{"ok":true}

  Депозит записан.

• 200{"ok":true,"idempotent":true}

  У этого перехода депозит уже был. Ничего не изменилось.

• 400{"error":"invalid parameters"}

  Нет clickId, или он короче 8 либо длиннее 100 символов; число не число, отрицательное или выше потолка; либо event длиннее 50 символов.

• 401{"error":"unauthorized"}

  Секрета нет или он неверный.

• 404{"error":"unknown clickId"}

  Перехода с таким id у нас нет. Проверьте, что отправляете полученное значение и берёте его из того параметра, который мы заполнили.

• 500{"error":"internal error"}

  Сбой на нашей стороне. Повторите позже с теми же параметрами.

• 503{"error":"postback disabled"}

  Приём постбеков у нас выключен. Напишите нам.

✦Повторы

Засчитываетсяпервый постбек

• ✦

  Первый принятый постбек по переходу записывает депозит: сумму, выплату и время прихода. Наша команда получает одно уведомление.

• ✦

  Любой следующий постбек по тому же переходу вернёт 200 с "idempotent": true и ничего не изменит, даже если сумма или выплата другие. Два вызова, пришедшие в один момент, всё равно оставят одну запись.

• ✦

  Поэтому сумму и выплату передавайте в первом же вызове. Повторные депозиты того же игрока здесь не записываются.

• ✦

  Срока годности у click id нет: депозит через несколько недель после перехода всё равно сматчится.

✦Подключение

Четыре шагадо запуска

Вопросы по интеграции: