Интеграция через Postback Lead без JS

Пример инструкции по интеграции

Для передачи данных о получении или изменении информации о целевом действии необходимо отправить HTTP-запрос методом POST.

Запрос

Адрес для запроса: https://api.ekacvda.com/postback/{offer}, где вместо:

{offer} – наименование оффера на платформе, которое будет предоставлено в специально подготовленной инструкции после согласования всех атрибутов запроса.

Атрибуты запроса

* – атрибут может не передаваться в некоторых случаях

Наименование	Тип значения	Описание
id	string	Идентификатор целевого действия (например, идентификатор заказа). Внимание: Должен быть уникальным. Формат: строка до 255 символов.
totalPrice *	integer	Сумма оплаты для целевого действия. * Может отсутствовать, если: – не потребуется для последующей сверки; – или не будет ставок на основе процента от суммы; – или запрос отправлен только для обновления статуса. Формат: число от 0 до 99999999.
coupon *	string	Промокод для атрибуции по промокодам. * Может не передаваться, если: – при совершении целевого действия промокод не использовался; – или запрос отправлен только для обновления статуса. Формат: строка до 128 символов.
clientType *	string	Тип клиента: – new — новый клиент; – old — существующий клиент. * Может отсутствовать, если запрос отправлен только для обновления статуса.
email *	string	Идентификатор клиента (email, телефон или другое значение). * Может отсутствовать, если: – запрос отправлен только для обновления статуса; – или не потребуется для последующей сверки. Формат: строка до 255 символов.
url *	string	URL последнего платного перехода со всеми параметрами. * Может отсутствовать, только если: – переход был не по платной ссылке; – или запрос отправлен только для обновления статуса.
marketing_cat *	string	Маркетинговая категория для определения ставок (список предоставляется в индивидуальной инструкции). * Может отсутствовать, если запрос отправлен только для обновления статуса.
status	integer	Статус целевого действия: 1 — совершено (например, заказ оформлен); 2 — подтверждено (например, заказ оплачен); 3 — отклонено (например, заказ отменён). Внимание: при ручной сверке отправляется только статус 1.
dateCreate *	string	Дата и время совершения целевого действия. * Может отсутствовать, если: – не потребуется для последующей сверки; – или это запрос для обновления статуса. Формат: `Y-m-d H:i:s`
timeLastChanged *	string	Дата и время обновления статуса целевого действия. * Может отсутствовать, если: – не потребуется для последующей сверки; – или это первый запрос для целевого действия. Формат: `Y-m-d H:i:s`

Если необходимы дополнительные атрибуты для последующей сверки или для вашей аналитики на нашей платформе, то потребуется сообщить о них для изменения алгоритмов обработки данных.

Ответ

Положительный ответ на корректный запрос будет с кодом 200 и телом в формате JSON.

Свойства объекта

* – свойство может отсутствовать

Наименование	Тип значения	Описание
success	boolean	Флаг принятия корректного запроса.
dt	string	Дата и время принятия запроса в часовом поясе GMT+3. Формат: `Y-m-d H:i:s`
status_code *	integer	Код ответа об ошибке. Соответствует стандартным HTTP-кодам. * Отсутствует в ответе на корректный запрос.
errors *	array	Список ошибок. * Отсутствует в ответе на корректный запрос. Формат: массив строк.

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

Примеры

Совершение целевого действия

5 сентября 2025 года в 13:00 (по Москве) существующий клиент с адресом электронной почты client@domain.com оформил заказ на сумму 3000 рублей c маркетинговой категорией 1. Для целевого действия был зарегистрирован идентификатор заказа с уникальным значением c8821c53-403f-4aeb-ae4e-9853d2d52fde.

Указанный клиент перед оформлением заказа перешёл на рекламируемый сайт website.ru по ссылке с метками:

https://website.ru/?utm_source=advcake&utm_medium=cpa&utm_campaign=affiliate&utm_content=test&advcake_params=5ad7308ea4cfb34847520984528d0b5d&utm_term=5ad7308ea4cfb34847520984528d0b5d

Запрос

POST /postback/{offer} HTTP/2
Host: api.ekacvda.com
Content-Type: application/json

    {
        "id": "c8821c53-403f-4aeb-ae4e-9853d2d52fde",
        "totalPrice": 300,
        "clientType": "old",
        "email": "client@domain.com",
        "url": "https://website.ru/?utm_source=advcake&utm_medium=cpa&utm_campaign=affiliate&utm_content=test&advcake_params=5ad7308ea4cfb34847520984528d0b5d&utm_term=5ad7308ea4cfb34847520984528d0b5d"
        "marketing_cat": "1",
        "status": 1,
        "dateCreate": "2025-09-05 13:00:00"
    }

Ответ

HTTP/2 200 OK
Content-Type: application/json

{        
    "success": true,
    "dt": "2025-09-05 13:00:01"
}

Подтверждение целевого действия

5 сентября 2025 года в 13:00:05 (по Москве) заказ со значением c8821c53-403f-4aeb-ae4e-9853d2d52fde был оплачен и целевое действие было подтверждено.

Запрос

В запросе передаются только те данные, которые необходимо изменить. Все переданные ранее данные для запроса с тем же идентификатором останутся неизменными.

POST /postback/{offer} HTTP/2
Host: api.ekacvda.com
Content-Type: application/json

{
    "id": "c8821c53-403f-4aeb-ae4e-9853d2d52fde",
    "status": 2,
    "updated": "2025-09-05 13:00:05"
}

Ответ

HTTP/2 200 OK
Content-Type: application/json

{
    "success": true,
    "dt": "2025-09-05 13:00:06"
}

Отклонение целевого действия

6 сентября 2025 года в 14:30:00 (по Москве) заказ со значением c8821c53-403f-4aeb-ae4e-9853d2d52fde был отклонён и оплата была возвращена.

Запрос

POST /postback/{offer} HTTP/2
Host: api.ekacvda.com
Content-Type: application/json

{
    "id": "c8821c53-403f-4aeb-ae4e-9853d2d52fde",
    "status": 3,
    "updated": "2025-09-06 14:30:00"
}

Ответ

HTTP/2 200 OK
Content-Type: application/json

{
    "success": true,
    "dt": "2025-09-05 14:30:01"
}

Вам помогла эта страница?

Последнее изменение: 12.02.2026

Интеграция через Postback Lead без JS

На этой странице: