> 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/obmen/nalichnye-obmeny.md).

# Наличные обмены

Инструкция по настройке направлений связанных с наличными

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

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

***

## Управление городами и странами

Для добавления и редактирования городов перейдите в административной панели в раздел **«Утилиты — Страны и города — Список городов».**

Здесь отображается список всех доступных городов с указанием страны, XML-обозначения, даты последнего обновления и текущего статуса.

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-484fa70295993d078aaaf1fc3e175c8b7cc9fa86%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Чтобы добавить новый город, нажмите кнопку **"Добавить город"**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-cea008a6eff6da3f86a7a50c7556f4680ae594f7%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

В открывшемся окне заполните необходимые поля:

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-20bb1d998c08ddc4f037bb7ad4b29d0b4a5225dd%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**Название —** укажите название города.

{% hint style="warning" %}

## Внимание!!!

Система автозаполнения автоматически проверит и заполнит следующие поля:

* **Страна —** определит страну, к которой принадлежит указанный город.
* **Обозначение XML —** автоматически подставит уникальное обозначение города, используемое для XML-выгрузок.
  {% endhint %}

Если автозаполнение не сработало или подходящего города не оказалось в списке:

* Выберите вручную страну из предложенного списка.
* В поле **«Обозначение XML»** самостоятельно укажите соответствующее значение.

  Чтобы узнать, какое значение необходимо указать, перейдите по ссылке ниже:

{% content-ref url="/pages/BwUxepr42WJjlQpEn4G2" %}
[Broken mention](broken://pages/BwUxepr42WJjlQpEn4G2)
{% endcontent-ref %}

**Статус —** выберите статус города («Включен» или «Отключен»).

После заполнения всех нужных полей нажмите кнопку **«Добавить»**, чтобы сохранить изменения.

{% hint style="info" %}
Подсказка: Список доступных стран можно найти в разделе **«Другие разделы — Список стран»**.
{% endhint %}

***

## Настройка городов для направлений обмена

После того как вы добавили необходимые города, перейдите в административной панели в раздел **«Основное — Направление обмена — Список направлений».** Выберите нужное направление и нажмите кнопку редактирования (значок карандаша).

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-e68e4224f12f7dab72cdc5e140d700b0caebd4fe%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Далее в левом меню перейдите в раздел **«Город»**.

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-ae1043be2ee0fa5564646228f6d525b20162da75%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

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

Можно выбрать сразу несколько городов.

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-ff4f0bdfa245775d0608fbbfaf0f5d6cf9957a7b%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Города можно включать и отключать одним кликом:

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

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

### Расширенные параметры для выбранных городов

Нажмите кнопку **«Показать все опции»**, чтобы открыть дополнительные настройки для каждого выбранного города:

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-25ea1af14fba5a36e5e108c0a18785a8757216d1%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}
Вы создаёте один профиль (например, прибыль 1% и надбавка к курсу +0.5%), привязываете его к нужным городам, и система автоматически использует эти значения в расчетах и шаблонах.
{% endhint %}

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

{% content-ref url="/pages/zlYB2ShFKsee65nRCjVg" %}
[Профили городов](/guide/obmen/profili-pribyli/profili-gorodov.md)
{% endcontent-ref %}

**Добавить к курсу —** укажите абсолютное значение, на которое будет изменён текущий курс обмена. Допустимые форматы: число (1, -1), процент (1%), умножение (\*1), деление (/1).

**Прибыль —** Укажите процент (%) или фиксированную сумму (S), которые будут являться прибылью обменника при каждом обмене для конкретного города.

{% hint style="warning" %}
*Если оставить значение 0, будет использоваться общее значение прибыли для направления обмена.*
{% endhint %}

**Метки для XML —** укажите специальные метки, которые будут передаваться в XML-файле, согласно [требованиям сервиса BestChange](https://www.bestchange.ru/wiki/rates.html). Для корректного заполнения используйте список допустимых меток.

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-042bb5dd4488033e857241da597cecab40b6ec02%2F2024-07-26_07-37-27.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**Мин. сумма обмена/Макс. сумма обмена —** Задайте минимальную и максимальную сумму обмена для выбранного города. Если оставить значения равными 0, будут использованы общие лимиты, установленные в настройках направления обмена.

**Инструкция по обмену —** Текст, который будет отображаться пользователю на странице оплаты заявки при совершении обмена для выбранного города. Здесь рекомендуется указать подробные шаги и информацию, необходимую для успешного завершения обменной операции.

**Описание обмена —** Дополнительная информация или пояснения, которые будут показаны пользователям на странице обмена в выбранном городе.

{% hint style="info" %}

## Доступные теги

Кнопка **«Доступные теги»** открывает список специальных тегов, которые можно использовать в текстах уведомлений, шаблонах сообщений, инструкциях и любых полях, где поддерживается подстановка значений.

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

Это позволяет:

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

**Ставка —** Дополнительный параметр, используемый в некоторых сценариях расчётов (оставьте значение пустым, если он не используется).

**Биржа —** Дополнительный параметр для интеграции с внешними системами бирж (оставьте значение пустым, если он не используется).

**Прибыль обменника для партнеров —** Используется для расчёта партнёрского вознаграждения. Укажите процент (%) или фиксированную сумму (S).

{% hint style="danger" %}
*<mark style="color:red;">Если выбрана опция</mark>* *<mark style="color:red;">**«расчёт от суммы обмена»**</mark><mark style="color:red;">, оставьте это поле равным 0.</mark>*
{% endhint %}

***

## Вопросы и Ответы

<details>

<summary>Изменение кнопки «Я оплатил» для конкретного направления обмена с наличными</summary>

Чтобы изменить название кнопки «Я оплатил» на странице заявки конкретного направления обмена наличных средств:

1. Перейдите в административной панели в раздел:

   **«Основное — Направление обмена — Список направлений».**
2. Выберите нужное направление и нажмите на кнопку редактирования.
3. В левом меню перейдите в раздел:

   **«Общее — Информация».**
4. Найдите поле «Уникальное название кнопки **«Я оплатил»** и укажите желаемое название.

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

</details>

<details>

<summary>Перевод названий стран на другие языки</summary>

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

1. В административной панели перейдите в раздел:

   **«Другие разделы — Список стран».**
2. Выберите нужную страну и перейдите к редактированию, нажав на её название.
3. В открывшемся окне используйте вкладки доступных языков (ru, en и другие) для указания перевода названия страны.

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

</details>

<details>

<summary>Отключение формы оплаты для направлений с наличными</summary>

Чтобы скрыть форму оплаты на странице заявки для определённого направления обмена с наличными средствами, выполните следующие действия:

1. В административной панели откройте раздел:

   **«Основное — Направление обмена — Список направлений».**
2. Выберите нужное направление и перейдите к редактированию.
3. В левом меню перейдите в раздел:

   **«Дополнительное — Ограничения и проверки».**
4. Найдите параметр **«Скрыть форму оплаты заявки»** и установите его значение на **«Да»**.

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

</details>