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

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

Обновлено Aug 24, 2026

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

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

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

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

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

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

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

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

Параметр Асинхронный режим (Рекомендуется) Синхронный режим
Принцип работы PRMonline мгновенно принимает запрос, возвращает ответ 200 OK / 202 Accepted отправляющей системе и ставит задачу на создание/обновление лида в очередь обработки. PRMonline сначала полностью обрабатывает запрос, заносит лид в базу данных и только после этого возвращает ответ отправляющей системе.
Преимущества Минимальное время отклика (миллисекунды). Исключает таймауты и задержки на стороне вашего сайта/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).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

POST https://api-public.prmonline.ru/hook/60124899-7c44-4214-84ea-cfb4cfb8434e?name=Олеся Римская&refLinkId=263545&sum=9300&id=19854444&status=NEW

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

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

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

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

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

  • status: NEW (Статус, соответствующий "Новый" в PRMonline)

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

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

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

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

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

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

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