Главная Кабинет партнера Создание входящего Postback

Создание входящего Postback

Обновлено Sep 25, 2026

Инструкция по настройке Postback-интеграции в кабинете партнера PRM Online

Postback (Webhook) — это механизм автоматической передачи данных о конверсиях, лидах и изменении их статусов из вашей внешней системы (CRM, сайта, мобильного приложения или трекера) в личный кабинет PRM Online.

С помощью Postback вы можете:

  • Автоматически создавать лиды в PRM Online при совершении целевых действий на вашем сайте.

  • Передавать и обновлять статусы сделок.

  • Передавать сумму сделок и уникальные идентификаторы.

1. Режимы обработки данных: асинхронный или синхронный

При создании Postback-интеграции выберите подходящий режим обработки входящих HTTP-запросов:

Параметр Асинхронный режим (рекомендуется) Синхронный режим
Принцип работы PRM Online мгновенно принимает запрос, возвращает ответ 200 OK / 202 Accepted отправляющей системе и ставит задачу на создание/обновление лида в очередь обработки. PRM Online сначала полностью обрабатывает запрос, заносит лид в базу данных и только после этого возвращает ответ отправляющей системе.
Преимущества Минимальное время отклика (миллисекунды). Исключает таймауты и задержки на стороне вашего сайта/CRM. Высокая отказоустойчивость при пиковых нагрузках. Гарантия того, что в ответе сервер сразу сообщит итоговый результат создания лида (успех или ошибку).
Когда использовать По умолчанию для всех стандартных интеграций, рекламных сетей, трекеров и сайтов с высоким трафиком. Когда отправляющей системе критически важно сразу получить финальный статус обработки или ID созданной записи.

2. Пошаговая настройка Postback в кабинете партнера

Шаг 1. Создание интеграции

  1. Перейдите в левое боковое меню и выберите раздел Настройки.

  2. Откройте вкладку Интеграции и нажмите кнопку Добавить интеграцию.

  3. На открывшемся экране отобразится URL вашего обработчика (уникальный адрес для отправки данных).

  4. Выберите Режим обработки (Асинхронный или Синхронный).

  5. Нажмите Следующий шаг.

Шаг 2. Сопоставление параметров получения данных (шаг 1 в мастере)

В этом окне необходимо указать, в каких GET/POST-параметрах ваша система будет передавать данные.

  • Укажите название интеграции (например, Мой сайт или CRM Сделки).

  • Код реферальной ссылки: укажите имя параметра, в котором передается ID реферальной ссылки (например, refLinkId).

    Где взять refLinkId? Перейдите в раздел Реферальная программа → Инструменты продвижения → Ссылки. В URL реферальной ссылки найдите значение GET-параметра (например, https://mysite.net?refLinkId=263545 → код ссылки 263545).

  • Промокод: укажите имя параметра, если атрибуция идет по промокоду (например, promocode).

  • Получение данных (дополнительные поля): нажмите +, чтобы добавить кастомные поля лида (например, наименование лида / имя клиента → поле name).

Нажмите Сохранить для перехода к следующему шагу.

Шаг 3. Сопоставление статусов и передача суммы (шаг 2 в мастере)

На этом этапе настраивается соответствие между статусами вашей системы и статусами PRM Online.

  1. Для каждого статуса PRM Online (Новый, В работе, Сделка, Отмена) укажите значение этапа, передаваемое вашей системой (по умолчанию: NEW, PURCHASE, PURCHASE_CONFIRM, PURCHASE_CANCEL).

    Системные идентификаторы статусов могут отличаться в вашем кабинете.

  2. Передавать стоимость: отметьте чекбокс напротив тех статусов, при наступлении которых должна фиксироваться сумма сделки (например, при подтверждении покупки PURCHASE_CONFIRM).

  3. Нажмите Сохранить.

Шаг 4. Дополнительные настройки (шаг 3 в мастере)

  1. Группировка сделок (Лид в PRM Online): укажите имя параметра, содержащего уникальный ID сделки/заказа/клиента в вашей системе (например, id). Это необходимо, чтобы последующие Postback-события об изменении статуса привязывались к существующему лиду, а не создавали дубли.

  2. Сумма сделки: укажите имя параметра, в котором передается сумма (например, sum).

  3. Нажмите Завершить.

3. Использование и копирование Postback URL

После завершения настройки вы можете просмотреть и скопировать готовый шаблон Postback URL:

  1. В разделе Настройки → Интеграции найдите созданную интеграцию.

  2. Нажмите на иконку ... (многоточие) и выберите Настройки.

  1. В появившемся окне выберите статус лида и скопируйте сгенерированный URL с макросами, нажав на иконку копирования.

  2. Также в этом окне вы можете изменить Режим обработки Postback, если это необходимо.

4. Пример проверки и тестирования через Postman

Вы можете протестировать работу настроенного Postback с помощью утилиты Postman или тестового HTTP-запроса из браузера/консоли.

Пример тестового URL-запроса

POST https://api-public.prmonline.ru/hook/ВАШ_ID_ИНТЕГРАЦИИ?name=Олеся%20Римская&refLinkId=263545&sum=9300&id=19854444&status=NEW

Параметры запроса (Query Params)

  • name: Олеся Римская (наименование лида)

  • refLinkId: 263545 (идентификатор реферальной ссылки)

  • sum: 9300 (сумма сделки)

  • id: 19854444 (уникальный ID транзакции/лида)

  • status: NEW (статус, соответствующий «Новый» в PRM Online)

5. Проверка результатов в кабинете

После успешной отправки Postback перейдите в раздел Лиды в левом меню кабинета партнера.

Новый лид отобразится в списке со всеми переданными параметрами:

  • Наименование лида: Олеся Римская

  • Источник: Реферальные ссылки

  • Статус: Новый

  • Оффер: Ваша партнерская программа