Recca Разработчикам
Меню

Постбэки и цели

Подписанный POST, GET-ссылка и цели воронки: как передать конверсию в сеть.

Постбэк — это запрос от вашего сервера к сети: «заказ такой-то состоялся». Сеть не видит вашу CRM и не знает о продаже ничего, пока вы о ней не сообщите. Гайд собирает всё о приёме конверсий в одном месте: адреса, подпись, статусы, цели, проверку и разбор ошибок.

Как считается конверсия

ШагКтоЧто происходит
1. Переходпартнёрчеловек приходит по ссылке; сеть создаёт клик и передаёт его идентификатор click_id параметром в адресе вашего сайта
2. Сохранениевыclick_id сохраняется в заказе рядом с его номером — единственная нить между переходом и продажей
3. Постбэкваш серверзаказ подтверждён — вы вызываете адрес постбэка оффера с click_id, номером заказа и статусом
4. Холдсетьвознаграждение считается по условиям оффера и резервируется на срок холда
5. Выплатасетьхолд закончился — деньги доступны партнёру

Постбэк без click_id сеть отклонит с 400 INVALID_INPUT. Если click_id пришёл, но такого перехода нет (потерян, искажён по дороге), сеть запишет факт продажи в состояние «переход не найден»: привязки к партнёру нет, денег никто не получает. Проверьте, что параметр доживает до создания заказа — чаще всего он теряется между лендингом и формой оплаты.

Быстрый старт: пять шагов

Всё, что нужно, — на странице «Приём результата (S2S)» в кабинете рекламодателя.

ШагГдеЧто сделать
1страница S2S, карточка оффераскопируйте адрес постбэка вида https://api.recca.ru/cpa/postback/<offer_id>
2страница S2Sнажмите «Выпустить секрет» и сохраните сразу: показывается один раз
3ваш сайтсохраняйте click_id из адреса в заказ, как utm-метки
4CRM или серверотправьте постбэк при подтверждении заказа — способом ниже
5страница S2Sвиджет «Проверить интеграцию», затем «Журнал постбэков»

Две двери

POST с подписьюGET-ссылка
кому подходитесть разработчикв CRM есть только поле «URL постбэка»
параметрытело JSONстрока запроса
право доступаHMAC-подпись в заголовкетокен secure в адресе
секретне покидает ваш сервертокен виден в журналах промежуточных серверов
статусрекомендуемыйзапасной

POST с подписью

Запрос

POST https://api.recca.ru/cpa/postback/<offer_id>
Content-Type: application/json
X-CPA-Signature: <подпись>

{
  "click_id": "clk_a1b2c3",
  "external_id": "order-10421",
  "status": "confirmed",
  "sum_rub": 5000,
  "sub_id": null
}

Поля

ПолеОбязательноЧто это
click_idдаидентификатор перехода, пришедший вам в ссылке
external_idдаваш номер заказа; ключ идемпотентности — повтор не создаёт вторую конверсию
statusдастатус заказа у вас, см. таблицу ниже
sum_rubдля процентных моделейсумма заказа в рублях
sub_idнетсквозная метка партнёра, если получали её в ссылке
goalнеткод цели воронки; не передан — основная ставка оффера
ОграничениеЗначение
external_id, sub_idдо 200 символов; номер заказа не может начинаться с recca:
sum_rubчисло
goalлатиница, цифры и _ . -, до 64 символов

Метки sub_id_2…sub_id_10 и идентификатор лендинга сеть берёт только из самого перехода: это разметка партнёра, и принять её из постбэка значило бы позволить рекламодателю переписывать разрез отчёта партнёра.

Подпись

HMAC-SHA256 в шестнадцатеричном виде, секретом оффера, от строки, собранной через двоеточие:

click_id:external_id:status:sum_rub:sub_id[:goal[:timestamp]]
ФормаКогда получаетсяПример
5 сегментовgoal не передан, метки времени нетclk:order-1:confirmed::
6 сегментовgoal передан — даже goal=1clk:order-1:confirmed::lead
7 сегментовпередан X-CPA-Timestamp; цели нет — шестой сегмент пустойclk:order-1:confirmed::lead:1760000000
ПравилоПочему
пустые значения остаются пустыми сегментаминет суммы и метки — строка заканчивается двумя двоеточиями; разделители не схлопываются
порядок полей фиксированне зависит от порядка полей в JSON
шестой сегмент появляется по факту передачи goalправило про присутствие поля, а не про значение
метка времени делает строку семисегментной всегдаиначе шесть сегментов означали бы то ли цель, то ли метку, и по содержимому их не отличить

Необязательные заголовки

ЗаголовокЧто делаетОтвет при нарушении
X-CPA-Timestampметка Unix в секундах; окно свежести ±5 минут403 STALE_SIGNATURE — чинится часами, а не секретом
X-CPA-Key-Idcurrent или previous; после ротации прежний секрет принимается ещё 7 суток403 UNKNOWN_KEY_ID

Повторяя отложенный постбэк из очереди, подписывайте его заново с текущей меткой: старую подпись окно уже не пропустит. Заголовок ключа без ротации не нужен — сеть проверяет оба слота сама.

Примеры

bash

SECRET="ваш_секрет"
CANON="clk_a1b2c3:order-10421:confirmed:5000:"
SIG=$(printf '%s' "$CANON" | openssl dgst -sha256 -hmac "$SECRET" -hex | awk '{print $2}')

curl -X POST "https://api.recca.ru/cpa/postback/$OFFER_ID" \
  -H "Content-Type: application/json" \
  -H "X-CPA-Signature: $SIG" \
  -d '{"click_id":"clk_a1b2c3","external_id":"order-10421","status":"confirmed","sum_rub":5000}'

PHP

$canon = implode(':', [$clickId, $orderId, 'confirmed', (string)$sum, '']);
$sig = hash_hmac('sha256', $canon, $secret);

$ch = curl_init("https://api.recca.ru/cpa/postback/{$offerId}");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ['Content-Type: application/json', "X-CPA-Signature: {$sig}"],
  CURLOPT_POSTFIELDS => json_encode([
    'click_id' => $clickId, 'external_id' => $orderId,
    'status' => 'confirmed', 'sum_rub' => $sum,
  ]),
  CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);

Python

import hmac, hashlib, requests

canon = f"{click_id}:{order_id}:confirmed:{sum_rub}:"
sig = hmac.new(secret.encode(), canon.encode(), hashlib.sha256).hexdigest()

requests.post(
    f"https://api.recca.ru/cpa/postback/{offer_id}",
    json={"click_id": click_id, "external_id": order_id,
          "status": "confirmed", "sum_rub": sum_rub},
    headers={"X-CPA-Signature": sig},
    timeout=10,
)

Node.js

import { createHmac } from 'node:crypto'

const canon = [clickId, orderId, 'confirmed', String(sum), ''].join(':')
const sig = createHmac('sha256', secret).update(canon).digest('hex')

await fetch(`https://api.recca.ru/cpa/postback/${offerId}`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-CPA-Signature': sig },
  body: JSON.stringify({
    click_id: clickId, external_id: orderId,
    status: 'confirmed', sum_rub: sum,
  }),
})

Ответы

КодЧто значит
201конверсия создана
200 с idempotent: trueзаказ уже был засчитан; второй раз вознаграждение не начисляется
400, 403, 404, 409, 500ошибка; код в теле — расшифровка в разделе «Коды ошибок»
429превышен лимит обращений; повторите после паузы из Retry-After

GET-ссылка для CRM

https://api.recca.ru/cpa/postback/<offer_id>?clickid={click_id}&action_id={order_id}&goal={goal}&sum={sum}&status=1&sub_id={sub_id}&secure=ВАШ_ТОКЕН_GET

Готовая строка для каждого оффера — на странице S2S, поле «Ссылка для CRM (GET)»: замените плейсхолдеры на макросы вашей CRM.

Токен secure

В адрес вставляется отдельный токен вида cpag_…, который выдаётся вместе с секретом — при создании оффера и при каждой ротации. Это не секрет подписи: он в адресную строку не попадает никогда. Токен выведен из секрета, поэтому ротация секрета отзывает и его — отдельной кнопки отзыва нет. Засветился — выпустите новый секрет на странице S2S и замените токен в CRM.

Имена параметров

ЧтоКак можно назвать
идентификатор переходаclickid, click_id
ваш номер заказаaction_id, external_id, actionid, order_id
сумма заказаsum, sum_rub, amount
метка партнёраsub_id, sub1, sub_id1
цель воронкиgoal
токен доступаsecure

Сумма принимается и с точкой, и с запятой: 5000, 5000.50, 5000,50.

Значения status

КодЧто означает
1подтверждено — начинается холд
2ожидание — конверсия записана, вознаграждение не начисляется
3отмена — гасит конверсию по политике сети
5у нас равно 1: подтверждение и так лежит на холде до конца срока

Два умолчания: нет status — постбэк считается подтверждением; нет action_id — номером заказа становится сам переход (click:{clickid}), и повторный вызов той же ссылки ничего не задваивает.

Проверка живого адреса:

curl -i "https://api.recca.ru/cpa/postback/$OFFER_ID?clickid=clk_test&action_id=order-1&sum=1000&status=1&secure=$GET_TOKEN"

201 — конверсия создана; 403 — токен не тот; 400 — нет clickid либо адрес оффера неверный.

Статусы, холд, отмена

Что вы присылаете

Числа понимает только GET-ссылка; в POST-запросе шлите слова — строго строчными.

POST:

ЗначениеКак поймёт сеть
pending, wait, waiting, on_holdожидание — конверсия записана, вознаграждение не начисляется
cancel, rejectотмена — гасит конверсию
любое другое слово (approved, sale…)подтверждение — начинается холд

⚠ Любое слово, которого нет в первых двух строках, — это подтверждение. declined, 3, Cancel в POST не отменят конверсию, а начнут холд.

GET:

ЗначениеКак поймёт сеть
1, 5, confirmed, approved, hold (и confirm, approve)подтверждено — начинается холд
2, pending, wait, waiting, on_holdожидание
3, cancel, reject, declined, trash (и cancelled, rejected, decline)отмена — гасит конверсию
любое другое значение или пустой statusподтверждение

В GET регистр не важен.

Что происходит на нашей стороне

Состояние конверсииДеньги партнёру
переход не найденнет; более поздний постбэк с верным click_id поднимет ту же строку
ожиданиенет
холдзарезервированы, идёт срок возврата
подтвержденодоступны к выплате
отмененонет; состояние конечное

Переходы намеренно узкие: из «подтверждено» назад в холд конверсия не возвращается — деньги не ходят задним ходом. Единственный выход из «подтверждено» — отмена с возвратом.

Отмена и возврат

Отправьте постбэк с тем же номером заказа и статусом отмены. Если заказ засчитан по цели, отмену нужно слать с той же целью — иначе сеть ответит, что отменять нечего.

Где вознаграждениеЧто произойдёт
на холдеаннулируется, никто ничего не теряет
начислено, но не выплаченосоздаётся обратная проводка
уже выплаченопо политике сети: удержание из будущих выплат или списание за счёт сети

Повторная отмена безопасна: операция идемпотентна и второй раз ничего не меняет.

Цели воронки

Один переход часто приносит цепочку событий: заявка, оплата, продление. Цели позволяют не заводить отдельный оффер на каждое.

...&action_id=order-10421&goal=lead              → заявка, ставка 300 ₽
...&action_id=order-10421&goal=deposit&sum=5000   → оплата, 12 % от суммы

Оба постбэка идут по одному переходу и с одним номером заказа — это две разные конверсии, каждая по своей ставке и со своим холдом.

ПравилоКак работает
goal не передандействует цель по умолчанию 1 — основная ставка оффера
уникальностьтройка «сеть + номер заказа + цель»; повтор той же тройки идемпотентен
один клик — одна выплата на цельвторой заказ той же цели с того же перехода → 409 ALREADY_CONVERTED, в сообщении — номер занявшего заказа
исключениямодель revshare; цель-веха; цель с флагом «несколько конверсий с клика»
неизвестная цельотказ 400 UNKNOWN_GOAL — молча заплатить по чужой ставке хуже, чем отказать
выключенная цельотказ 409 GOAL_DISABLED — оператор сети временно остановил приём новых конверсий по цели; уже записанные подтверждаются и возвращаются как раньше
лимит офферадо 50 целей

Флаг «несколько конверсий с клика» у цели включает оператор сети: тогда каждый заказ той же цели с того же перехода платится своей конверсией. В списке целей на странице S2S у каждой видны код, название, ваша ставка, холд и этот флаг; цель с кодом 1 переопределяет основную ставку оффера. Выключенная цель в этом списке помечена отдельно — приём по ней остановлен до включения.

Оператору: капы оффера считают каждую денежную конверсию независимо от цели — воронка из двух целей расходует кап вдвое быстрее.

Веха — цель за ноль: она не создаёт вознаграждения и не расходует лимит, но показывает доходимость воронки — где именно она ломается.

Макросы адреса рекламодателя

Для операторов и партнёров: в адрес, куда сеть отправляет трафик, можно вставить макросы.

МакросЧто подставится
{clickid}, {click_id}идентификатор перехода
{pid}, {partner_id}псевдоним партнёра для этого оффера
{subid}, {sub_id}метка партнёра
{sub1} … {sub10}метки партнёра, имена Affise
{sub_id_2} … {sub_id_10}дополнительные метки партнёра
{webmaster_id}, {aff_id}номер вебмастера — только если сеть включила передачу, иначе пусто
{offer_id}идентификатор оффера
{landing_id}идентификатор лендинга
ПравилоПоведение
неизвестный макросраскрывается в пустую строку
click_id не дописывается самв адресе с макросами идентификатор перехода берите макросом {clickid}
значения кодируютсяподстановка URL-кодируется

Про {pid}: это не идентификатор партнёра, а псевдоним, стабильный в пределах одного оффера, — ключ для вашей отчётности, который не позволяет опознать одного и того же партнёра в разных офферах и сетях. Про {webmaster_id}: короткий номер вебмастера слепоту снимает, поэтому по умолчанию выключен; включает владелец сети в «Правилах сети».

Пример: https://example.com/promo?utm_campaign={pid}&clickid={clickid}

Повторы и лимиты

СитуацияОтвет двери
повтор с тем же заказом и целью, та же сумма200, idempotent: true — повторная отправка безопасна
повтор с другой суммой409 IDEMPOTENT_MISMATCH: сумма — часть операции; другое событие шлите своим номером
номер заказа занят чужим оффером той же сети409 EXTERNAL_ID_CONFLICT — добавьте свой префикс к нумерации

Повтор — правильный способ пережить обрыв связи. Лимиты: 2 000 запросов в минуту на оффер (оператор может задать своё значение от 60 до 20 000) и 30 отказов по праву в минуту с одного адреса (неверная подпись, неверный токен, несуществующий оффер — верно подписанные запросы это ведро не расходуют); превышение — 429 RATE_LIMITED с заголовком Retry-After. Номер заказа уникален в пределах сети, а не оффера.

Проверка интеграции

Виджет «Проверить интеграцию»

Вставьте секрет ровно так, как он прописан в вашей CRM — с теми же пробелами и кавычками. Сеть подпишет тестовый постбэк именно им и прогонит через боевой приёмник: несовпадение секрета вы увидите здесь, а не на первом реальном заказе. Тестовая конверсия создаётся по-настоящему, но помечается и не попадает ни в статистику, ни в счёт, ни в выплаты.

Журнал постбэков

Каждый запрос к вашим офферам за последние 90 дней: время, оффер, дверь (POST или GET), цель, ваш номер заказа, присланный статус дословно, ответ сети.

СимптомПричинаЧто делать
строки нетзапрос не дошёл, либо в адресе неверный идентификатор оффера — такие не записываютсяпроверьте адрес и то, что сервер вообще отправляет запрос
ответ 403не совпал секрет или подписьвиджет проверки
200 и «повтор»заказ уже был засчитанне ошибка: задвоение исключено
«переход не найден»click_id потерян между лендингом и формойпроверьте передачу параметра до создания заказа

Оператор сети видит тот же журнал по всем рекламодателям: обращаясь в поддержку, называйте время запроса и номер заказа.

Коды ошибок

Каждый ответ приёмника несёт код. Ниже — все коды, которые может увидеть рекламодатель, и что с ними делать.

INVALID_INPUT · HTTP 400

Не хватает обязательного поля либо значение не проходит проверку: нет click_id, external_id или status; сумма не число или больше допустимого; sub_id длиннее 200 символов; код цели содержит недопустимые символы.

Что делать: Сверьте отправляемые поля со списком в разделе «Поля» выше. Частая причина — макрос CRM не подставился и уехал в запрос как есть (sum={cost_money_value}).

OFFER_NOT_FOUND · HTTP 400

В адресе указан идентификатор оффера, которого нет, либо у оффера не заведены условия CPA и секрет.

Что делать: Возьмите адрес постбэка со страницы «Приём результата (S2S)» — там он готовый, для каждого вашего оффера. Такой запрос не попадает в журнал: он не принадлежит ни одной сети.

BAD_SIGNATURE · HTTP 403

Подпись в заголовке X-CPA-Signature не совпала с той, что ожидает сеть: другой секрет либо строка собрана в другом порядке.

Что делать: Проверьте секрет виджетом «Проверить интеграцию» — он подписывает тестовый постбэк ИМЕННО тем секретом, который вы вставите, и прогоняет через боевой приёмник. Если секрет верный — проверьте порядок полей в строке подписи и то, что пустые значения остаются пустыми сегментами.

BAD_SECURE · HTTP 403

В GET-ссылке параметр secure не совпал с токеном оффера. ⚠ Туда вставляется НЕ секрет подписи, а отдельный токен вида cpag_…: строка запроса целиком попадает в журналы промежуточных серверов, и ключу, которым подписывается тело, там не место.

Что делать: Токен выдаётся вместе с секретом — при создании оффера и при каждой ротации, один раз. Если он утерян, выпустите новый секрет на странице S2S: токен перевыпустится вместе с ним. Прежнее значение параметра (сам секрет) больше не принимается — это не переходный период, а смена контракта.

STALE_SIGNATURE · HTTP 403

Подпись верна, но заголовок X-CPA-Timestamp вне окна свежести — пять минут в обе стороны — либо не является меткой времени Unix в секундах.

Что делать: Сверьте часы сервера, с которого уходят постбэки: окно двустороннее, поэтому спешащие часы отбиваются так же, как отстающие. Если вы повторяете отложенный постбэк из очереди — подписывайте его ЗАНОВО с текущей меткой, а не отправляйте сохранённое тело со старой.

UNKNOWN_KEY_ID · HTTP 403

Заголовок X-CPA-Key-Id назвал слот секрета, которого не существует. Допустимы current и previous.

Что делать: Заголовок необязателен: без него сеть проверяет оба слота сама. Присылайте его, только если точно знаете, каким ключом подписали; неизвестное значение отбивается намеренно, иначе заголовок ничего не означал бы.

WINDOW_EXPIRED · HTTP 409

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

Что делать: Смотрите «Окно атрибуции» в условиях оффера. Если ваш цикл сделки длиннее окна — договоритесь с сетью об увеличении, задним числом конверсия не засчитывается.

ALREADY_CONVERTED · HTTP 409

По этому переходу уже засчитана конверсия на ту же цель, но с другим номером заказа. Один клик оплачивается один раз на цель.

Что делать: Если это продолжение воронки — пришлите постбэк с другой целью (goal), а не с новым номером заказа. Если это тот же заказ — отправьте прежний external_id, и повтор попадёт в идемпотентность.

ILLEGAL_TRANSITION · HTTP 409

Запрошенный переход статуса невозможен: например, подтвердить конверсию, по которой уже прошёл возврат.

Что делать: Посмотрите текущий статус заказа в сверке. Отменённая конверсия терминальна — новое подтверждение оформляется новым external_id.

UNKNOWN_GOAL · HTTP 400

В постбэке указана цель, которой у оффера нет.

Что делать: Список целей оффера — на странице S2S под ставкой. Сеть намеренно не подставляет ставку «по умолчанию» вместо неизвестной цели: заплатить по чужой ставке хуже, чем отказать.

GOAL_DISABLED · HTTP 409

Цель выключена оператором сети, а конверсии по ней раньше не было: новые конверсии по выключенной цели не принимаются. Отказ виден в журнале постбэков с этим кодом.

Что делать: Это состояние конфликта, а не кривой запрос: ставки и история цели сохранены, но приём остановлен. Попросите оператора включить цель на странице целей оффера либо шлите другую цель. Уже записанные конверсии по ней подтверждаются и возвращаются как раньше — отказ касается только новых.

EXTERNAL_ID_CONFLICT · HTTP 409

Этот номер заказа уже занят в сети по этой же цели — но другим оффером, не вашим.

Что делать: Номер заказа уникален в пределах СЕТИ, а не оффера, поэтому у двух рекламодателей со сквозной нумерацией с единицы номера пересекутся. Добавьте к external_id собственный префикс. Раньше в этом случае постбэк молча переписывал чужую конверсию, поэтому отказ — это не новое ограничение, а прекращение тихой порчи данных.

IDEMPOTENT_MISMATCH · HTTP 409

Постбэк по этому заказу и этой цели уже приходил, но с ДРУГОЙ суммой. Раньше такой повтор получал успех и прежние деньги — то есть сеть подтверждала сумму, которой не начисляла.

Что делать: Сумма — часть операции, а не её уточнение. Если сумма изменилась (доплата, пересчёт, частичный возврат), это ДРУГОЕ событие: пришлите его под своим external_id. Если это добросовестный повтор — пришлите ту же сумму, и он попадёт в идемпотентность. ⚠ «Не передали сумму» и «передали ноль» — разные значения: постбэк без sum_rub не совпадает с постбэком, где sum_rub=0.

NOT_CONVERTED · HTTP 400

Рекламодатель прислал отмену (статус «отклонено») по заказу, у которого по этой цели ещё не было подтверждения. Это штатный исход, а не сбой: отмена записана (строка «отклонено»), и подтверждение по этому заказу и цели уже не пройдёт. Снаружи ответ всегда 400 — он одинаков для «заказа не было» и «был, но не засчитан», чтобы по ответу нельзя было перебирать чужие номера заказов.

Что делать: Действий не требуется, если рекламодатель и должен был отклонить этот заказ (например, цель «сделка провалена»). Ошибка — только если вы ждали ПОДТВЕРЖДЕНИЕ по этому заказу: тогда проверьте в журнале, что подтверждение и отмена идут с одним номером заказа и одной целью — отмена ищет конверсию по тройке «сеть + номер заказа + цель».

NOT_FOUND · HTTP 404

Денежная нога отменяемой конверсии не найдена — отменять нечего.

Что делать: Как правило, конверсия уже отменена. Проверьте статус в сверке: повторная отмена безопасна и ничего не меняет.

REVERSAL_FAILED · HTTP 500

Возврат начался, но не завершился на нашей стороне.

Что делать: Повторите запрос: операция идемпотентна. Если повторяется — сообщите оператору сети время запроса и номер заказа, строка есть в журнале.

RATE_LIMITED · HTTP 429

Превышен лимит обращений. Вёдер ДВА, и исчерпать достаточно одно: по офферу — 60 запросов в минуту, по адресу отправителя — 300. Ответ несёт заголовок Retry-After с паузой в секундах.

Что делать: Ставьте постбэки в очередь и берите паузу из Retry-After, а не из своей константы. Лимит общий для обеих дверей (POST и GET) — переезд на другой транспорт его не обходит. ⚠ Ведро оффера считается по идентификатору в адресе: несколько ваших офферов не мешают друг другу, а вот один оффер, нагруженный с нескольких серверов, делит общий счёт.

INTERNAL_ERROR · HTTP 500

Сбой на нашей стороне: запрос дошёл, но обработать его не удалось. Конверсия при этом не создана.

Что делать: Повторите запрос позже: приёмник идемпотентен, дубликат не создаст вторую конверсию. Если повторяется — напишите оператору сети.

Постбэки вебмастера: диагностика доставки

Это обратное направление: сеть сообщает о конверсиях на сервер или трекер вебмастера GET-запросом по адресу, который вебмастер задал в кабинете. Адрес собирается из макросов ({click_id}, {sub1} … {sub10}, {transactionid}, {goal}, {sum}, {payout}, {status} и других).

⚠ {click_id} — это идентификатор клика в сети Recca, а не в вашем трекере. Идентификатор клика трекера обычно приезжает в одной из меток (sub1 … sub10) из ссылки, поэтому в адрес подставляйте нужную метку, например {sub2}, а не {click_id}.

Что в кабинетеЧто делает
«Проверить»отправляет тестовую доставку по адресу выбранного статуса. Макросы тестовые: click_id = test_click, метки sub1 … sub10 = test_sub1 … test_sub10, номер заказа test-transaction; настоящий клик не берётся, чтобы тест не создал в трекере живую конверсию. Не чаще пяти проверок за пять минут
Журнал доставокпо каждой доставке: адрес как ушёл (токен бота скрыт), код ответа, причина сбоя и отрывок ответа сервера — вебмастеру до 2000 знаков, оператору сети первые 300; токены в отрывке скрыты. Показываются последние сто доставок
«Не доходит»плашка у постбэка: три последние нетестовые доставки подряд мёртвые, ни одной успешной между ними. Одна успешная доставка плашку снимает
«Отправить заново»возвращает в очередь мёртвые доставки за последние семь суток (не больше двухсот за вызов): адрес собирается заново по текущему шаблону. Доставленные и тестовые не трогаются; постбэк должен быть включён; не чаще пяти раз за пять минут

Успешной считается любая доставка с ответом 2xx. Иначе доставка повторяется с паузами 1 минута, 5 минут, 15 минут, 1 час и 6 часов — всего шесть попыток; после шестой неудачи она становится мёртвой — «Прекращено после ошибок» в журнале.

Частые вопросы

Отправляю сумму, а она не сохраняется

Три проверки по журналу: доехал ли постбэк (есть ли строка); не уехал ли макрос CRM как есть — sum={cost_money_value} вместо числа отбивается как неверный ввод; та ли цель — сумма относится к конверсии той цели, которую вы назвали.

Заявка засчиталась, а оплата — нет

Скорее всего, оба постбэка ушли без цели: второй попадает в идемпотентность первого — номер заказа тот же, цель та же. Передавайте goal для каждого события воронки.

Можно ли слать постбэки с нескольких серверов

Да. Лимит считается на оффер (2 000 запросов в минуту по умолчанию), а не на адрес: с адреса ограничиваются только отказы по праву — 30 в минуту.

Секрет утёк — что делать

Выпустите новый на странице S2S и обновите его в CRM. Прежний принимается ещё 7 суток, но столько же действует и утёкший — меняйте сразу, а неделя пусть остаётся страховкой от простоя.

Оффер ведёт оператор, своего входа нет

Попросите оператора: у него та же кнопка в списке офферов. Секрет показывается один раз — получить и передать его нужно сразу и защищённым каналом.

Тем, кто управляет сетью машиной, а не руками, посвящён соседний гайд: «Go SDK».

О возможности целиком — какие задачи решают постбэки в CPA-сети — читайте на странице Постбэки S2S.