Обновление статуса заявки на платформе

Для обновления статуса заявки при интеграции через postback-запрос вы можете использовать методы, описанные в статье Интеграция через postback-запрос.

Для того чтобы обновить статус заявки на платформе, нужно отправить GET-запросы.

GET-запрос, чтобы обновить статус на "Подтверждён":

Вариант 1. Используя идентификатор оффера и идентификатор лида в системе рекламодателя. Для того, что бы подтвердить лид, выполните GET запрос по указанному URL:

https://www.marketcall.ru/api/v1/postback/update?api_key={КЛЮЧ_API}&state=approved&offer_id={OFFER_ID}&merchant_own_id={MERCHANT_OWN_ID}

Вариант 2. Используя идентификатор перехода (как при создании лида). Для того, что бы подтвердить лид, выполните GET запрос по указанному URL. Данный запрос идентичен запросу на создание лида.

https://www.marketcall.ru/api/v1/postback?session_uuid={ИДЕНТИФИКАТОР_ПЕРЕХОДА}&state=approved&merchant_own_id={MERCHANT_OWN_ID}&action=Lead

GET-запрос, чтобы обновить статус на "Отклонён":

Вариант 1. Используя идентификатор оффера и идентификатор лида в системе рекламодателя. Для того, что бы отклонить лид, выполните GET запрос по указанному URL:

https://www.marketcall.ru/api/v1/postback/update?api_key={КЛЮЧ_API}&state=refused&state_reason={ПРИЧИНА_ОТКЛОНЕНИЯ}&offer_id={OFFER_ID}&merchant_own_id={MERCHANT_OWN_ID}

Вариант 2. Используя идентификатор перехода (как при создании лида). Для того, что бы отклонить лид, выполните GET запрос по указанному URL. Данный запрос идентичен запросу на создание лида.

https://www.marketcall.ru/api/v1/postback?session_uuid={ИДЕНТИФИКАТОР_ПЕРЕХОДА}&state=refused&state_reason={ПРИЧИНА_ОТКЛОНЕНИЯ}&merchant_own_id={MERCHANT_OWN_ID}&action=Lead

ИДЕНТИФИКАТОР_ПЕРЕХОДА - уникальный идентификатор перехода (session_uuid). Подробнее

ИДЕНТИФИКАТОР_ОФФЕРА - уникальный идентификатор оффера рекламодателя на платформе Marketcall.

ПРИЧИНА_ОТКЛОНЕНИЯ - причина отклонения лида. Возможные значения:

"duplicate" - дубликат
"invalid" - не соответствует требуемому набору данных
"trash" - спам

MERCHANT_OWN_ID - уникальный идентификатор заявки в базе данных рекламодателя. Рекламодатель генерирует идентификатор у себя и подставляет в GET-запрос. Идентификатор должен быть уникальным и привязанным к лиду в системе рекламодателя. По нему будут автоматически подтверждаться / отклоняться лиды, а также можно будет провести ручную сверку.

API_KEY - уникальный ключ безопасности рекламодателя. Его можно взять в личном кабинете рекламодателя на платформе Marketcall.