> For the complete documentation index, see [llms.txt](https://premium.gitbook.io/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://premium.gitbook.io/main/osnovnye-nastroiki/merchanty-i-avtovyplaty/merchanty/evo-pay.md).

# 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="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-f7a75ec1b5243e39c7857761db2ee27021db9c27%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-86face5aa49cf58a8ead0de4c02fdad8d064d807%2Fimage.png?alt=media" alt="" width="324"><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

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

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

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-077a94ff2f2abc676a716393b59f4eab513e6acd%2Fimage.png?alt=media" alt="" width="424"><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-71ac1550bff693bf97eddf56138afd5507d095a8%2Fimage.png?alt=media" alt="" width="455"><figcaption></figcaption></figure>

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

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-a3132b2be5861c8060ca2c7e53d7ece703b88518%2Fimage.png?alt=media" 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="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-8f22186bde061d3ec72d491b42c28dbf48dabe8c%2Fimage.png?alt=media" 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>