Использование оффера (campaigns/redeem)

Агрегатор или магазин передает в сервис ЮMoney информацию о лидах — об использовании скидки или бонуса пользователями.

Запрос

Адрес для отправки запроса

POST https://yoomoney.ru/api/offerwall/v1/campaigns/redeem

Параметры

Параметр	Тип	Описание
ymCampaignId	int	Идентификатор кампании в сервисе ЮMoney. Возвращается в ответе на запрос campaigns/create. Обязательный параметр
pinContent	string	Содержание пин-кода (буквенно-числовая строка, регистр символов не учитывается). См. campaigns/create Обязательный для кампаний с `campaignType=codeOnline` и `campaignType=codeOffline` с одноразовыми пин-кодами (`one-off`).
clickId	string	Уникальный идентификатор клика. Генерируется в сервисе ЮMoney в момент ссылки и добавляется к `acceptUrl` (уникальная ссылка для получения оффера, по которой перенаправляется пользователь, см. campaigns/create). Обязательный для кампаний: `campaignType=banner`; `campaignType=promo`; `campaignType=codeOnline` с `pinType=reusable`; `campaignType=codeOffline` с `pinType=reusable`.
transactionId	string (36)	Идентификатор заказа на стороне магазина (в рамках которого использован оффер). Должен быть уникальным для одной рекламной кампании. Подойдут монотонно возрастающие числа, строка случайных символов или любой другой вариант. Обязательный параметр
redeemStatus	enum	Статус лида. Возможные значения: `used` — лид совершен пользователем; `approved` — магазин или агрегатор выплачивает вознаграждение сервису ЮMoney за этот лид; `declined` — магазин или агрегатор не будет выплачивать вознаграждение сервису ЮMoney за этот лид (например, при возврате товара). Необязательный параметр
sceneRedeem	string	Место совершения лида (использования скидки или бонуса). Необязательный параметр
redeemTime	datetime	Время совершения лида (использования скидки или бонуса). Необязательный параметр
campaignFee	varchar (30)	Размер вознаграждение ЮMoney по факту совершения лида. Число в рублях или долларах, два знака после точки. Обязательный параметр
feeCurrency	CurrencyCode	Код валюты вознаграждения ЮMoney. `643` — рубль РФ (задается по умолчанию, если значение не передано); `840` — доллар США. Необязательный параметр
orderAmount	varchar (30)	Сумма заказа. Число в рублях или долларах, два знака после точки. Необязательный параметр
orderCurrency	CurrencyCode	Код валюты заказа. `643` — рубль РФ (задается по умолчанию, если значение не передано); `840` — доллар США. Необязательный параметр
cashbackAmount	varchar (30)	Сумма кэшбэка. Число в рублях или долларах, два знака после точки. Необязательный параметр
viewId	string	Уникальный идентификатор показа оффера. Генерируется в сервисе ЮMoney и добавляется к `acceptUrl` (уникальная ссылка для получения оффера, по которой перенаправляется пользовательь, см. campaigns/create). Рекомендуется использовать в паре с `bonusDescription`. Необязательный параметр
bonusDescription	object	Описание получаемого бонуса или скидки. Рекомендуется использовать в паре с `viewId`. Необязательный параметр
bonusDescription.category	string	Категория покупки, совершенной пользователем в вашем сервисе. Описывается в свободной форме. Пример: `Красота и здоровье` Необязательный параметр

Пример тела запроса

JSON

{
    "ymCampaignId": 1,
    "clickId": "019d653d-31e0-7fd5-b752-40e0e270ab7f",
    "transactionId": "1234567890123456",
    "orderAmount": 7056,
    "orderCurrency": 643,
    "cashbackAmount": 84,
    "redeemTime": "2026-02-11T10:05:22.000Z",
    "redeemStatus": "approved",
    "viewId": "4f97b7d3-0677-4f60-b1af-9f2c0f233500",
    "bonusDescription": {
        "category": "Красота и здоровье"
    }
}

Пример запроса

cURL

curl -X POST \
--header 'Content-Type: application/json' \
--header 'Accept: application/json;charset=UTF-8' \
--header 'Authorization: Bearer <авторизационный токен>' -d '{
    "ymCampaignId": 1,
    "clickId": "019d653d-31e0-7fd5-b752-40e0e270ab7f",
    "transactionId": "1234567890123456",
    "orderAmount": 7056,
    "orderCurrency": 643,
    "cashbackAmount": 84,
    "redeemTime": "2026-02-11T10:05:22.000Z",
    "redeemStatus": "approved",
    "viewId": "4f97b7d3-0677-4f60-b1af-9f2c0f233500",
    "bonusDescription": {
        "category": "Красота и здоровье"
    }
}' 'https://yoomoney.ru/api/offerwall/v1/campaigns/redeem'

Ответ

Состояние операции (в обработке или ошибка).