> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/marketing/partnyorskaya-programma/sozdanie-partnyorskoi-programmy.md).

# Создание партнёрской программы

Партнёрская программа определяет условия начисления вознаграждения пользователям, которые привлекают клиентов по реферальным ссылкам.

В программе настраиваются:

* публичное название;
* описание условий;
* процент партнёрского вознаграждения;
* минимальное гарантированное начисление;
* срок действия реферальной привязки;
* тексты для разных языков сайта.

После создания программу необходимо включить в общих настройках партнёрской системы, выбрать программой по умолчанию или назначить конкретному партнёру.

Создание программы само по себе не запускает начисления.

### Где находится раздел

В панели управления откройте: **«Партнёрам» — «Реферальные программы»**

<figure><img src="/files/zRmR3cjcTC1Bvet0knCY" alt=""><figcaption></figcaption></figure>

Для работы с разделом группе администратора должно быть предоставлено право управления партнёрскими программами.

### Для чего нужны разные программы

Можно создать несколько программ с разными условиями.

Например:

* стандартная программа для всех пользователей;
* повышенная программа для крупных партнёров;
* программа для блогеров;
* программа с расчётом от прибыли;
* программа с гарантированным минимальным начислением;
* программа с отдельным сроком реферальной привязки.

Одна программа может назначаться автоматически, а другие — вручную выбранным партнёрам.

## Как работает партнёрская программа

1. Администратор создаёт реферальную программу.
2. Программа назначается партнёру.
3. Для партнёра создаётся реферальная ссылка.
4. Клиент переходит по ссылке.
5. Система сохраняет реферальную информацию в браузере.
6. При регистрации клиент связывается с партнёром.
7. Клиент создаёт и завершает обмен.
8. Система проверяет настройки программы, партнёра и направления.
9. Рассчитывается вознаграждение.
10. Сумма зачисляется на партнёрский баланс.
11. Операция сохраняется в журнале реферальной системы.

Для начисления должны быть правильно настроены:

* общая партнёрская система;
* реферальная программа;
* партнёр;
* направление обмена;
* способ расчёта;
* валюта партнёрского баланса.

## Создание программы

В разделе «Реферальные программы» нажмите: **«Добавить программу»**

Откроется форма со следующими полями:

* название программы;
* описание;
* процент партнёра;
* срок действия;
* минимальное гарантированное начисление.

{% stepper %}
{% step %}

### Название программы

Укажите понятное название, по которому программу можно отличить от остальных.

Примеры:

```
Стандартная — 1%
Партнёрская — 0.5%
VIP-партнёры — 30% от прибыли
Блогеры — 2%
Программа по умолчанию
```

Название поддерживает несколько языков.

Обязательно заполните основной язык системы. Для остальных языков добавьте переводы, если они используются на сайте.

Название может отображаться:

* в списке реферальных программ;
* в настройке программы по умолчанию;
* в карточке партнёра;
* в связанных административных разделах;
* в личном кабинете партнёра, если это поддерживается используемой темой.

Внутреннее системное имя создаётся автоматически. Пользователю не нужно его придумывать или изменять.
{% endstep %}

{% step %}

### Описание

В описании укажите условия участия понятным для партнёра языком.

Пример программы от суммы обмена:

> Партнёр получает 1% от расчётной суммы каждого успешно завершённого обмена привлечённого клиента. Вознаграждение начисляется после выполнения заявки и зачисляется на партнёрский баланс.

Пример программы от прибыли:

> Партнёр получает 30% от прибыли обменника по успешно завершённым заявкам привлечённых клиентов. Прибыль определяется настройками соответствующего направления обмена.

Описание заполняется отдельно для каждого языка.

Рекомендуется указать:

* от чего рассчитывается вознаграждение;
* когда оно начисляется;
* какие заявки участвуют;
* какие ограничения действуют;
* установлен ли гарантированный минимум;
* какой срок действует реферальная связь;
* при каких условиях можно запросить выплату.

Не указывайте условия, которые не настроены в административной панели.
{% endstep %}

{% step %}

### Процент партнёра

Поле «Процент партнёра» определяет размер вознаграждения.

Можно использовать целые и дробные значения:

```
0.5
0.75
1
10
30
```

Значение:

```
1
```

означает `1%`, а не `100%`.

{% tabs %}
{% tab title="Расчёт от суммы обмена" %}
Допустим:

```
Расчётная сумма: 1000 USD
Процент программы: 1%
```

Расчёт:

```
1000 × 1% = 10 USD
```

Партнёру будет начислена сумма, эквивалентная `10 USD` в валюте партнёрского баланса.
{% endtab %}

{% tab title="Расчёт от прибыли обменника" %}
Допустим:

```
Прибыль обменника: 20 USD
Процент программы: 30%
```

Расчёт:

```
20 × 30% = 6 USD
```

Партнёру будет начислено `6 USD` или эквивалент в настроенной валюте партнёрского баланса.
{% endtab %}
{% endtabs %}

#### Где выбирается способ расчёта

Поле программы задаёт только процент. Оно не определяет базу, от которой рассчитывается вознаграждение.

На странице реферальных программ нажмите кнопку с иконкой настроек.

В разделе «Настройки партнёров» найдите параметр: **«Тип вознаграждений»**

{% content-ref url="/pages/TIY3c859sG8UHEvTh39d" %}
[Настройка партнёрских вознаграждений](/guide/marketing/partnyorskaya-programma/nastroika-partnyorskikh-voznagrazhdenii.md)
{% endcontent-ref %}

Доступны два варианта:

* «От суммы обмена»;
* «От прибыли в настройках направлений».
  {% endstep %}
  {% endstepper %}

### Приоритет процентов

Сначала система выбирает источник процента:

1. Индивидуальный процент партнёра.
2. Индивидуальный процент направления.
3. Процент реферальной программы.

После этого значение может быть ограничено:

* максимальным процентом направления;
* персональным максимальным процентом партнёра.

{% stepper %}
{% step %}

#### Индивидуальный процент партнёра

Настраивается в карточке пользователя.

Если у партнёра указан персональный процент, он заменяет процент программы и индивидуальный процент направления.

Пример:

```
Процент программы: 1%
Индивидуальный процент партнёра: 1.5%
```

Для этого партнёра будет использоваться:

```
1.5%
```

{% endstep %}

{% step %}

#### Индивидуальный процент направления

Настраивается в карточке направления.

В панели управления откройте: **«Основное» — «Направления обмена» — «Список направлений»**

Выберите направление и откройте раздел **«Партнёрская программа»**.

Если персональный процент партнёра не установлен, но в направлении задан индивидуальный процент, система использует процент направления.
{% endstep %}

{% step %}

#### Максимальный процент

Максимальное значение может ограничиваться:

* направлением обмена;
* карточкой партнёра.

Пример:

```
Процент программы: 5%
Максимум направления: 2%
```

Для этого направления будет применено не более:

```
2%
```

Перед запуском программы проверьте, что ограничения направления и пользователя не уменьшают ожидаемое вознаграждение.
{% endstep %}

{% step %}

#### Фиксированная партнёрская выплата

В направлении можно установить фиксированную выплату.

Если она указана, система использует её вместо процентного расчёта.

Пример:

```
Фиксированная выплата: 2 USD
Процент программы: 1%
```

Итоговое вознаграждение:

```
2 USD
```

Процент программы в этом случае не применяется.
{% endstep %}
{% endstepper %}

## Минимальное гарантированное начисление

Поле задаёт минимальную сумму, которую партнёр должен получить за одну подходящую заявку.

Сумма указывается в валюте партнёрского баланса. Текущая валюта отображается рядом с полем.

Пример:

```
0.20 USD
```

Если рассчитанное вознаграждение составило:

```
0.08 USD
```

система увеличит его до:

```
0.20 USD
```

Если расчёт дал:

```
0.50 USD
```

партнёр получит `0.50 USD`, поскольку сумма уже превышает установленный минимум.

### Допустимый формат

Можно указать не более четырёх знаков после точки.

Корректные значения:

```
0
0.1
0.20
0.1234
1
10.5000
```

Отрицательные значения не допускаются.

### Как отключить гарантированный минимум

Укажите:

```
0
```

При нулевом значении программа не увеличивает слишком маленькие начисления.

## Связь с минимумом направления

В направлении обмена также может быть установлен минимум партнёрского начисления.

Если гарантированный минимум включён в программе, система выбирает большее значение:

* минимум программы;
* минимум направления.

Пример:

```
Минимум программы: 0.20 USD
Минимум направления: 0.50 USD
```

Итоговый гарантированный минимум:

```
0.50 USD
```

Другой пример:

```
Минимум программы: 0.20 USD
Минимум направления: 0.10 USD
```

Итоговый минимум:

```
0.20 USD
```

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

## Связь с максимальным начислением

Гарантированный минимум имеет приоритет над максимальным ограничением.

Если максимум установлен ниже гарантированного минимума, итоговая сумма может быть увеличена до гарантии программы.

Пример нежелательной конфигурации:

```
Максимум направления: 0.10 USD
Гарантированный минимум программы: 0.50 USD
```

В таком случае гарантия программы окажется выше установленного максимума.

**Важно.** Не создавайте противоречивые настройки. Гарантированный минимум не должен превышать максимальную выплату направления.

## Срок действия программы

Поле «Срок действия (минуты)» определяет, сколько времени сохраняется реферальная информация после перехода клиента по партнёрской ссылке.

Значение указывается в минутах.

| Период    | Значение |
| --------- | -------: |
| 1 день    |     1440 |
| 7 дней    |    10080 |
| 30 дней   |    43200 |
| 90 дней   |   129600 |
| 5 месяцев |   216000 |
| 1 год     |   525600 |
| 3 года    |  1576800 |

В форме также доступны быстрые варианты:

* «5 месяцев»;
* «1 год»;
* «3 года».

### Если срок указан

Значение конкретной программы имеет приоритет над общим сроком хранения реферальной информации.

Например:

```
Общая настройка: без ограничения
Срок программы: 43200 минут
```

Для этой программы реферальная информация будет храниться 30 дней.

### Если поле пустое или равно нулю

Система использует общие настройки партнёрской системы:

* без ограничения по времени;
* либо установленное количество дней.

### Что происходит после изменения срока

Новый срок применяется при следующей установке или обновлении реферальной cookie.

Уже сохранённая в браузере информация может продолжить действовать до ранее установленной даты окончания.

## Сохранение программы

После заполнения формы нажмите:**«Добавить»**

Кнопка становится доступна, если:

* название заполнено на основном языке;
* описание заполнено на основном языке;
* указан процент;
* минимальное начисление имеет правильный формат.

После сохранения программа появится в таблице.

***

## Список программ

Для каждой программы отображаются:

* название;
* краткое описание;
* процент;
* минимальное гарантированное начисление;
* срок действия;
* дата создания;
* дата последнего изменения;
* отметка «По умолчанию»;
* действия редактирования и удаления.

Если срок не задан, отображается:

```
Без срока
```

Если минимальное начисление равно нулю:

```
Отключено
```

## Включение партнёрской системы

{% content-ref url="/pages/AC2l2SiiYcIET21YCvBU" %}
[Настройки партнерской программы](/guide/marketing/partnyorskaya-programma/nastroiki-partnerskoi-programmy.md)
{% endcontent-ref %}

На странице реферальных программ нажмите кнопку с иконкой настроек.

<figure><img src="/files/5MQci7VpGz4EnMavOxBl" alt=""><figcaption></figcaption></figure>

В разделе «Настройки партнёров» включите: **«Включить реферальную программу»**

Если параметр выключен, новые вознаграждения не начисляются, даже если программы, ссылки и проценты настроены правильно.

Отключение партнёрской системы:

* не удаляет программы;
* не удаляет ссылки;
* не обнуляет баланс;
* не удаляет историю;
* останавливает новые начисления.

## Программа по умолчанию

Созданная программа не становится основной автоматически.

В разделе «Настройки партнёров» найдите поле: **«Программа по умолчанию»**

Выберите созданную программу и сохраните настройки.

После этого она будет назначаться новым пользователям, для которых система создаёт реферальную ссылку.

### Что происходит после изменения

Изменение программы по умолчанию:

* применяется к новым реферальным ссылкам;
* не изменяет ранее созданные ссылки;
* не переносит существующих партнёров;
* не пересчитывает прошлые начисления.

В списке выбранная программа отмечается как «По умолчанию».

## Тип вознаграждений

{% content-ref url="/pages/TIY3c859sG8UHEvTh39d" %}
[Настройка партнёрских вознаграждений](/guide/marketing/partnyorskaya-programma/nastroika-partnyorskikh-voznagrazhdenii.md)
{% endcontent-ref %}

{% stepper %}
{% step %}

### От суммы обмена

Процент применяется к расчётной сумме обмена.

Этот вариант подходит, если партнёр должен получать предсказуемый процент от оборота.

Перед запуском проверьте:

* используемую расчётную сумму;
* комиссии;
* ограничения направления;
* валюту партнёрского баланса.
  {% endstep %}

{% step %}

### От прибыли в настройках направлений

Партнёр получает процент от рассчитанной прибыли обменника.

Для каждого направления необходимо настроить прибыль.

Если прибыль направления равна нулю, партнёрское вознаграждение также может оказаться нулевым, даже если в программе установлен процент.
{% endstep %}
{% endstepper %}

## Валюта партнёрского баланса

До запуска программы настройте валюту баланса.

В панели управления откройте: **«Настройки» — «Общие настройки»**

Затем перейдите в раздел **«Баланс системы»**.

<figure><img src="/files/r3kfrlXRl0Y5nZ1dwkmB" alt=""><figcaption></figcaption></figure>

В выбранной валюте отображаются:

* партнёрские начисления;
* гарантированный минимум;
* минимальная выплата;
* ограничения направлений;
* партнёрский баланс.

Рекомендуется выбрать валюту баланса до создания и запуска реферальных программ.

## Индивидуальные настройки партнёра

В карточке пользователя могут быть доступны:

* индивидуальный процент;
* максимальный процент;
* индивидуальный способ расчёта;
* разрешение на партнёрские выплаты;
* назначенная программа.

Индивидуальные настройки изменяют условия только для выбранного партнёра.

Если для всех участников должны использоваться одинаковые условия, оставьте индивидуальные значения равными нулю или выберите общие настройки.

## Как рассчитывается вознаграждение

Перед начислением система проверяет:

1. Включена ли партнёрская система.
2. Существует ли связь клиента с партнёром.
3. Принадлежит ли заявка привлечённому клиенту.
4. Разрешены ли начисления партнёру.
5. Разрешено ли вознаграждение в направлении.
6. Выбран ли способ расчёта.
7. Определена ли расчётная база.
8. Установлен ли процент или фиксированная выплата.
9. Доступен ли курс конвертации в валюту баланса.
10. Выполнены ли минимальные и максимальные ограничения.
11. Не начислялось ли вознаграждение по этой заявке ранее.

После проверки сумма зачисляется на партнёрский баланс и сохраняется в истории.

## Примеры настройки

### Программа 1% от суммы обмена

Параметры программы:

```
Название: Стандартная — 1%
Процент: 1
Минимальное начисление: 0
Срок: 525600 минут
```

Общие настройки:

```
Партнёрская система: включена
Тип вознаграждения: От суммы обмена
Программа по умолчанию: Стандартная — 1%
```

Если база расчёта составляет `1000 USD`:

```
1000 × 1% = 10 USD
```

Партнёру будет начислено `10 USD` или эквивалент в валюте баланса.

### Программа 30% от прибыли

Параметры программы:

```
Название: 30% от прибыли
Процент: 30
Минимальное начисление: 0
Срок: 525600 минут
```

Общие настройки:

```
Тип вознаграждения: От прибыли в настройках направлений
```

В направлении:

```
Прибыль обменника: 4%
Партнёрские выплаты: разрешены
```

Если расчётная база составляет `1000 USD`:

```
Прибыль обменника: 1000 × 4% = 40 USD
Вознаграждение партнёра: 40 × 30% = 12 USD
```

Партнёру будет начислено `12 USD` или эквивалент в валюте баланса.

### Программа с гарантированным минимумом

Параметры:

```
Процент: 0.5%
Гарантированный минимум: 0.20 USD
```

Если расчёт дал:

```
0.08 USD
```

партнёр получит:

```
0.20 USD
```

Если расчёт дал:

```
0.75 USD
```

партнёр получит:

```
0.75 USD
```

## Редактирование программы

Нажмите на название программы или кнопку редактирования.

Можно изменить:

* название;
* описание;
* процент;
* минимальное начисление;
* срок действия.

Изменённые условия применяются к будущим расчётам существующих партнёров этой программы.

Ранее начисленные суммы не пересчитываются.

Изменение названия или описания не изменяет реферальные ссылки.

## Удаление программы

Программу можно удалить только при отсутствии связанных реферальных ссылок.

Если она назначена пользователям, система заблокирует удаление.

Перед удалением:

1. Выберите другую программу по умолчанию.
2. Проверьте пользователей и реферальные ссылки.
3. Перенесите партнёров на другую программу.
4. Убедитесь, что удаляемая программа больше не используется.
5. Повторите удаление.

Удаление не предназначено для временного отключения программы.

У каждой программы нет отдельного переключателя активности. Для остановки всех новых начислений используется общий параметр:

**«Включить реферальную программу»**

## Как проверить работу

После настройки выполните тестовый цикл.

1. Создайте программу.
2. Выберите её программой по умолчанию.
3. Включите партнёрскую систему.
4. Выберите тип вознаграждения.
5. Проверьте валюту партнёрского баланса.
6. Настройте тестовое направление.
7. Создайте тестового партнёра.
8. Получите его реферальную ссылку.
9. Откройте ссылку в отдельном браузере или режиме инкогнито.
10. Зарегистрируйте нового клиента.
11. Создайте тестовую заявку.
12. Завершите обмен.
13. Проверьте баланс партнёра.
14. Сверьте сумму с ручным расчётом.
15. Проверьте журнал реферальной системы.

## Частые ошибки

<details>

<summary>Вознаграждение не начисляется</summary>

Проверьте:

* включена ли партнёрская система;
* назначена ли партнёру программа;
* существует ли реферальная ссылка;
* зарегистрирован ли клиент по этой ссылке;
* разрешены ли начисления партнёру;
* включены ли выплаты в направлении;
* не равен ли процент нулю;
* не установлена ли фиксированная выплата;
* настроена ли прибыль направления;
* доступен ли курс в валюту партнёрского баланса;
* не ограничен ли процент направлением;
* не находится ли сумма ниже минимального порога;
* не начислялся ли бонус ранее.

</details>

<details>

<summary>Расчёт от прибыли даёт нулевое вознаграждение</summary>

Проверьте прибыль в настройках направления.

Если расчётная прибыль равна нулю, процент партнёра также рассчитывается от нулевой базы.

</details>

<details>

<summary>Используется другой процент</summary>

Проверьте приоритет:

1. индивидуальный процент партнёра;
2. индивидуальный процент направления;
3. процент программы;
4. максимальные ограничения.

Также проверьте фиксированную выплату направления.

</details>

<details>

<summary>Начисление оказалось выше максимума</summary>

Проверьте гарантированный минимум программы.

Если он выше максимального начисления направления, система может увеличить результат до гарантированного минимума.

</details>

<details>

<summary>Новая программа не назначается партнёрам</summary>

Проверьте, выбрана ли она программой по умолчанию.

Изменение программы по умолчанию не переносит существующих партнёров автоматически.

</details>

<details>

<summary>Не удаётся удалить программу</summary>

У программы остались связанные пользователи или реферальные ссылки.

Перенесите партнёров на другую программу и повторите удаление.

</details>

<details>

<summary>Клиент не связался с партнёром</summary>

Проверьте:

* использовалась ли реферальная ссылка;
* не закончился ли срок привязки;
* разрешены ли cookies;
* не был ли клиент зарегистрирован ранее;
* не использовалась ли другая ссылка;
* сохранилось ли событие в журнале.

</details>

## Рекомендуемая последовательность

1. Настройте валюту партнёрского баланса.
2. Создайте партнёрскую программу.
3. Включите партнёрскую систему.
4. Выберите программу по умолчанию.
5. Выберите способ расчёта.
6. Настройте срок реферальной связи.
7. Включите журнал действий.
8. Настройте партнёрские параметры направлений.
9. Проверьте индивидуальные настройки пользователей.
10. Выполните тестовый обмен.
11. Сверьте расчёт, баланс и журнал.

## Рекомендации

* Сначала определите, будет ли вознаграждение рассчитываться от оборота или прибыли.
* При расчёте от прибыли настройте каждое рабочее направление.
* Не устанавливайте гарантированный минимум выше максимума направления.
* Не используйте слишком высокий процент без проверки экономики обмена.
* Заполните понятное описание на всех языках сайта.
* Не обещайте партнёрам условия, которые не настроены в системе.
* Включите журналирование до запуска.
* Проверяйте индивидуальные настройки партнёров.
* Проведите тестовый обмен перед публикацией программы.
* После изменения условий повторно проверьте расчёт.

## Коротко

Партнёрская программа определяет процент, гарантированный минимум и срок реферальной связи.

Способ расчёта — от суммы обмена или прибыли — выбирается в общих настройках партнёров.

Для начисления необходимо включить партнёрскую систему, назначить программу, настроить направления и проверить валюту баланса.

Индивидуальные настройки партнёра и направления могут заменить процент программы, а фиксированная выплата направления имеет приоритет над процентным расчётом.

***

{% content-ref url="/pages/XBgGc4uYSuRcyGxAnrJs" %}
[Настройка партнёрских программ для отдельных направлений обмена](/guide/marketing/partnyorskaya-programma/nastroika-partnyorskikh-programm-dlya-otdelnykh-napravlenii-obmena.md)
{% endcontent-ref %}

{% content-ref url="/pages/TIY3c859sG8UHEvTh39d" %}
[Настройка партнёрских вознаграждений](/guide/marketing/partnyorskaya-programma/nastroika-partnyorskikh-voznagrazhdenii.md)
{% endcontent-ref %}

{% content-ref url="/pages/AC2l2SiiYcIET21YCvBU" %}
[Настройки партнерской программы](/guide/marketing/partnyorskaya-programma/nastroiki-partnerskoi-programmy.md)
{% endcontent-ref %}

{% content-ref url="/pages/oncpa956kkB87pjEgjoW" %}
[Почему партнёры не получают бонусы и как это исправить](/guide/marketing/partnyorskaya-programma/pochemu-partnyory-ne-poluchayut-bonusy-i-kak-eto-ispravit.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/guide/marketing/partnyorskaya-programma/sozdanie-partnyorskoi-programmy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
