# Evo Pay

{% hint style="info" %}
Если вам необходимо обновить модуль на сервере — воспользуйтесь [инструкцией](https://premium.gitbook.io/main/osnovnye-nastroiki/faq/obnovlenie-failov-skripta-na-servere/kak-obnovit-faily-na-servere#moduli-merchantov-i-avtovyplat)
{% endhint %}

## Настройки в личном кабинете мерчанта

{% hint style="warning" %}
Для обсуждения условий и подключения свяжитесь с представителем сервиса (<https://t.me/evopayceo> или <https://t.me/tethermckenna>).

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

Авторизуйтесь в [личном кабинете EVO](https://evo-pay.net/login). Перейдите в раздел "**Settings**" и создайте API ключ по кнопке "**Create API KEY**".

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

Скопируйте сгенерированный ключ (без `API KEY:`) в буфер обмена или текстовый файл.

<figure><img src="/files/MU10dOnOVuWnAvnBtIjE" alt="" width="324"><figcaption></figcaption></figure>

Перейдите в настройки модуля в админ-панели Premium Exchanger.

Для работы вебхука изменения статуса заявок укажите URL из настроек модуля мерчанта в ЛК EVO. Дополнительно добавьте в вайтлист вашего файрвола все IP-адреса мерчанта, с которых они отправляют вебхуки (список IP-адресов запрашивайте напрямую у мерчанта).

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

Для обновления статусов заявок без использования задания Cron добавьте вебхук в ЛК EVO, выберите метод "**Order**" и вставьте скопированный ранее URL для вебхука. Сохраните изменения.

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

## Настройки модуля

В панели администратора создайте нового мерчанта в разделе "**Мерчанты**" ➔ "**Добавить мерчант".**

Выберите Evo в выпадающем списке в поле "**Модуль**", укажите название для модуля и нажмите "**Сохранить**".

<figure><img src="/files/lBQdftLKSv8dJ9fCeNOK" alt="" width="422"><figcaption></figcaption></figure>

Заполните указанные авторизационные поля.

<figure><img src="/files/9Fh1bRBpOdN3RKdp2UvS" alt="" width="424"><figcaption></figcaption></figure>

**Домен** — оставьте поле пустым

**API ключ** — API ключ, скопированный ранее в ЛК мерчанта

## Особые поля

<figure><img src="/files/Wqe5rp2R6bEVqWr834FP" alt="" width="455"><figcaption></figcaption></figure>

**Способ оплаты** — выберите подходящий способ для приема средств от клиента (по умолчанию доступны 2 метода: `BANK_CARD` — для получения реквизитов банковских карт и `SBP` — для получения номера телефона для пополнения через СБП).

<figure><img src="/files/ytkaXNo3xHq7ofTxknoh" alt="" width="318"><figcaption></figcaption></figure>

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

**Добавить** — добавление собственных способов оплаты (не используется без инструкции от мерчанта)

{% hint style="warning" %}
Для каждого используемого способа оплаты необходимо создать отдельную копию модуля мерчанта, в которой выбрать соответствующий способ, а затем подключить эту копию на вкладке "**Мерчанты и выплаты**" в настройках направления обмена, где в валюте "**Отдаю**" будет подходящая валюта
{% endhint %}

**Пересчет заявки, если сумма платежа изменилась** — опция, работающая по аналогии с [основной опцией пересчета суммы по заявке](https://premium.gitbook.io/main/osnovnye-nastroiki/valyuty-i-napravleniya-obmena/sozdanie-novogo-napravleniya#pereschet-po-summe-oplaty).

{% hint style="warning" %}
Если заявка указана на сумму 5000 рублей, мерчант может потребовать внесение суммы в пределах 4999.50–5000.50 рублей (возможное отклонение — до 100 рублей). При этом мерчант может как потребовать отличающуюся сумму, так и принять указанную изначально.

Таким образом, если клиенту отображается сумма в 5000 рублей, мерчант может не зафиксировать платеж автоматически, если фактически внесённая сумма будет незначительно отличаться (на несколько рублей или копеек).

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

Новая сумма и пересчёт осуществляются на основании выбранного значения в параметре "**Сумма, ожидаемая к зачислению**".

<img src="/files/sUyjUxSHdI4u00Te21rd" alt="" data-size="original">

Если функция пересчёта в настройках мерчанта включена, система автоматически обработает расхождение, дополнительное вмешательство не требуется.

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

**Статус работы** — отображается статус подключения модуля ("<mark style="color:green;">**ОК**</mark>" - модуль подключен, "<mark style="color:red;">**ОШИБКА**</mark>" - ошибка при авторизации в модуле, требуется указать валидный API-ключ)

## Продолжение настройки

Далее произведите настройку мерчанта следуя [общей инструкции по настройке](https://premium.gitbook.io/rukovodstvo-polzovatelya/osnovnye-nastroiki/merchanty-i-avtovyplaty/merchanty/obshie-nastroiki-merchantov).<br>


---

# Agent Instructions: 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:

```
GET https://premium.gitbook.io/main/osnovnye-nastroiki/merchanty-i-avtovyplaty/merchanty/evo-pay.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.