> 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/integracii/merchanty-i-api/strategiya-obrabotki-oshibok-merchantov.md).

# Стратегия обработки ошибок мерчантов

Во время создания заявки система обращается к выбранному мерчанту, чтобы получить реквизиты для оплаты, ссылку на оплату (Checkout) или другие данные, необходимые клиенту.

Иногда мерчант может временно не ответить, вернуть ошибку или не предоставить реквизиты. В таких случаях iEXExchanger использует выбранную стратегию обработки ошибок.

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

## Где находится настройка

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

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

На странице **«Настройки обмена»** найдите параметр:

**«Стратегия обработки ошибок мерчантов»**

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

* Без повторных попыток
* Повторять попытки
* Использовать альтернативный мерчант

После изменения настройки нажмите «Сохранить».

***

## Для чего нужна эта настройка

Даже надёжные мерчанты иногда могут работать нестабильно.

Например:

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

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

***

## Без повторных попыток

{% stepper %}
{% step %}

### Как работает

Это самый осторожный вариант работы.

Система обращается к мерчанту только один раз.

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

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

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

{% step %}

### Когда использовать

Этот вариант рекомендуется использовать, если:

* мерчант может создавать платёж ещё до отправки ответа;
* повторный запрос может привести к созданию дубля;
* требуется ручная проверка проблемных заявок;
* мерчант некорректно обрабатывает повторные обращения;
* безопасность важнее автоматизации.
  {% endstep %}

{% step %}

### Преимущества

* минимальный риск создания дублей;
* отсутствуют лишние обращения к API мерчанта;
* проще контролировать проблемные заявки;
* безопасный вариант для чувствительных платёжных систем.
  {% endstep %}

{% step %}

### Недостатки

* временные ошибки не исправляются автоматически;
* оператору может потребоваться вмешательство;
* уровень автоматизации ниже.
  {% endstep %}
  {% endstepper %}

***

## Повторять попытки

{% stepper %}
{% step %}

### Как работает

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

Всего выполняется до трёх попыток.

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

Если реквизиты уже были успешно получены ранее, повторный запрос не выполняется.
{% endstep %}

{% step %}

### Когда выполняется повтор

Повторные обращения выполняются только для ошибок, которые считаются временными.

Например:

* отсутствует ответ от API;
* превышено время ожидания;
* временная ошибка провайдера;
* HTTP 408;
* HTTP 429;
* ошибки HTTP 5xx.
  {% endstep %}

{% step %}

### Когда повтор не выполняется

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

Например:

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

Это предотвращает создание повторных платежей и других нежелательных ситуаций.
{% endstep %}

{% step %}

### Когда использовать

Этот вариант рекомендуется, если:

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

{% step %}

### Преимущества

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

{% step %}

### Недостатки

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

***

## Использовать альтернативный мерчант

{% stepper %}
{% step %}

### Как работает

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

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

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

При повторном выборе ранее использованный мерчант исключается из поиска.
{% endstep %}

{% step %}

### Как выбирается альтернативный мерчант

Новый мерчант должен соответствовать всем условиям направления.

Например:

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

Если подходящего мерчанта найти не удалось, реквизиты автоматически выданы не будут.
{% endstep %}

{% step %}

### Когда использовать

Этот вариант рекомендуется использовать, если:

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

{% step %}

### Преимущества

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

{% step %}

### Недостатки

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

***

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

Наиболее эффективно стратегия «Использовать альтернативный мерчант» работает вместе с правилами мерчантов.

Именно правила определяют:

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

Если правила не настроены, система использует более простой механизм выбора по валюте.

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

## Связь с лимитами мерчантов

При выборе мерчанта система также учитывает его ограничения.

Например:

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

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

## Где искать причины ошибок

Для диагностики откройте раздел: **«Журнал событий» — «Логи заявок» — «Журнал выбора и получения мерчанта»**

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

В журнале можно посмотреть:

* какой мерчант был выбран;
* какое правило использовалось;
* выполнялись ли повторные попытки;
* была ли попытка переключения на резервный мерчант;
* какую ошибку вернул API;
* на каком этапе произошла проблема;
* почему обработка была остановлена.

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

## Какой вариант выбрать

{% stepper %}
{% step %}

#### Если используется один мерчант

Для большинства случаев рекомендуется начать с варианта: **«Без повторных попыток»**

Если периодически возникают временные ошибки API, можно перейти на режим:

**«Повторять попытки»**
{% endstep %}

{% step %}

#### Если используется несколько мерчантов

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

* настроить правила мерчантов;
* проверить лимиты каждого мерчанта;
* использовать стратегию «Использовать альтернативный мерчант».

Это позволит автоматически переключаться между провайдерами без участия оператора.
{% endstep %}

{% step %}

#### Если мерчант не поддерживает повторные запросы

Если повторное обращение может привести к созданию дублирующего платежа, рекомендуется использовать режим: **«Без повторных попыток»**
{% endstep %}
{% endstepper %}

***

## Что проверить после изменения настройки

После изменения стратегии рекомендуется создать тестовую заявку.

Убедитесь, что:

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

Особенно важно протестировать режим «Использовать альтернативный мерчант», так как его работа зависит от правильной настройки мерчантов, направлений обмена и правил выбора.

***

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

Для большинства обменников с одним мерчантом рекомендуется использовать режим «Без повторных попыток».

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

Если в системе настроено несколько мерчантов с резервированием, наиболее эффективным вариантом будет «Использовать альтернативный мерчант» вместе с правилами мерчантов.

## Коротко

Настройка «Стратегия обработки ошибок мерчантов» определяет действия системы, если мерчант не смог выдать реквизиты для оплаты.

Можно выбрать один из трёх режимов:

* Без повторных попыток — самый безопасный вариант.
* Повторять попытки — автоматически повторяет запрос при временных ошибках.
* Использовать альтернативный мерчант — переключается на резервного мерчанта при невозможности получить реквизиты через основного.

Выбор подходящей стратегии зависит от особенностей ваших мерчантов, требований к отказоустойчивости и уровня автоматизации обменника.


---

# 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/integracii/merchanty-i-api/strategiya-obrabotki-oshibok-merchantov.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.