Вы можете создавать рекламные кампании для сайтов: когда пользователь использует пин-код на сайте (codeOnline) или получает бонус по специальной ссылке (promo). Есть специальный тип кампаний для обычных магазинов, когда пользователь показывает продавцу распечатанный пин-код или штрихкод (codeOffline).

Сервис ЮMoney показывает пользователю пин-код на скидку, а потом перенаправляет на ваш сайт. Пользователь вводит пин-код в специальное поле (например, при оформлении заказа) и получает скидку или бонус. Пин-код может быть многоразовым (то есть общим для всех пользователей) или одноразовым (уникальным для каждого пользователя).

Вместе с этим типом кампании обязательно передаются:

Пользователь переходит в ваш магазин по специальной ссылке (acceptUrl) и автоматически получает скидку или бонус. Пин-коды при этом способе передавать не нужно.

Пользователь получает пин-код или штрихкод, а потом показывает продавцу в вашем магазине, чтобы получить скидку или бонус.

В этом случае нужен только пин-код (одноразовый или многоразовый). Его можно передавать в двух вариантах: в виде уникального кода из букв и цифр (pinDisplayType=text) или в виде штрихкода (pinDisplayType=ean_13).

Пин-коды бывают одноразовыми и многоразовыми.

Одноразовый пин-код (pinType=one-off) означает, что каждый код можно использовать только один раз. То есть каждому новому пользователю нужно показывать новый уникальный код. В этом случае вам нужно загрузить список пин-кодов с помощью метода campaigns/add-pins.

Многоразовый пин-код (pinType=reusable) можно использовать сколько угодно раз, то есть всем пользователям сервис ЮMoney покажет один и тот же код. В этом случае пин-код загружается в параметре couponCode.

Любые пин-коды могут отображаться в виде слова, кода или штрихкода (за это отвечает атрибут pinDisplayType).

Если он равен text, вы можете передать в поле couponCode любой набор символов. Пользователь введет эти символы на вашем сайте или покажет продавцу и сможет получить скидку.

Если pinDisplayType=ean_13, вам нужно передать в поле couponCode 13 цифр, на основе которых сервис ЮMoney сформирует штрихкод и покажет пользователю. По этому штрихкоду пользователь сможет получить скидку.