Параметры постбека

Полный справочник параметров входящего постбека — алиасы, валидация, коды ответа и дедупликация.

Справка по параметрам входящего постбека (трекер → darkcore). Практическая настройка — Постбеки потока и Интеграция с Keitaro.

Адрес приёма

https://edge.darkcorepwa.com/p

Принимаются GET и POST: query-параметры, form-urlencoded или JSON. Если значение передано и в query, и в теле POST, побеждает query. Есть легаси-алиас пути /postback — работает идентично.

Параметры

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

Параметр	Алиасы	Обязательный	Описание
`click_id`	`clickid`, `cid`, `subid`, `sub_id`	да	Идентификатор клика darkcore, полученный трекером через `{click_id}`
`status`	`goal`, `event`	да	Статус конверсии (регистрация, депозит, кастомный)
`payout`	`sum`, `amount`, `revenue`	нет	Сумма выплаты; всегда в USD
`transaction_id`	`txid`, `tx_id`, `transactionid`, `conversion_id`, `conv_id`	нет	Идентификатор для дедупликации

Правила валидации

Значение длиннее 512 символов игнорируется (считается отсутствующим).
payout должен быть числом в диапазоне 0…1 000 000, иначе сводится к 0.
Валюты нет — весь payout считается в долларах США.

Сопоставление статусов

status сопоставляется с типом конверсии воркспейса по ключу или алиасу. Базовые соответствия (когда кастомный реестр не задан):

Входящий статус	Тип
`reg`, `registration`, `lead`	registration
`dep`, `deposit`, `ftd`, `first_deposit`, `sale`	deposit

Любой другой непустой статус без совпадения → ответ 400 invalid_status. Чтобы принимать собственные статусы, добавьте их как алиасы в Настройки → Конверсии.

Коды ответа

Ситуация	Ответ
Успех	`200 ok`
Дубликат (тот же `transaction_id`, или `click_id + status` без tx_id)	`200 ok`
Отсутствующий / слишком длинный `click_id`	`200 ok` (чтобы не раскрывать внутреннее состояние)
Неизвестный непустой `status`	`400 invalid_status`
Превышен лимит запросов	`429`
Инфраструктурная ошибка	`500` — трекер должен повторить

На коды 500 трекер должен делать ретрай. Коды 200 и 400 — финальные, повторять их не нужно.

Дедупликация

С transaction_id — уникальность по нему; каждая конверсия (даже повторный депозит того же клика) записывается отдельно.
Без transaction_id — уникальность по паре click_id + status.

Поэтому для повторяющихся событий (повторные депозиты, ребиллы) всегда передавайте уникальный transaction_id.

Авто-достройка регистрации

Если приходит deposit без предшествующей registration, darkcore синтезирует событие регистрации автоматически — чтобы воронка, пиксели и push не ломались.