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

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

Довідка по параметрах вхідного постбека (трекер → 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 не ламалися.