> For the complete documentation index, see [llms.txt](https://manual.boxexchanger.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.boxexchanger.net/obmen/merchant-i-api/payplay/merchant-payplay.md).

# Мерчант PayPlay

Инструкция по настройке мерчанта PayPlay

{% stepper %}
{% step %}

## Установка мерчанта

Используя параметры ниже, установите мерчант через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin.md).

<details open>

<summary>Параметры для Install Plugin</summary>

**Plugin type**: <mark style="color:orange;">**`Merchant module`**</mark>

**Plugin URL**: <mark style="color:orange;">**`@boxexchanger-plugins/merchant-payplay`**</mark>

**Directory path**: <mark style="color:orange;">**`payplay`**</mark>

**Auth: (Deploy token)**: оставляем пустым

**Package tag**: <mark style="color:orange;">**`latest`**</mark>

</details>
{% endstep %}

{% step %}

## Настройка мерчанта

{% hint style="info" %}
В случае, если вы ранее уже настраивали модуль выплаты PayPlay и у вас уже создана платежная страница, а также сохранен API ключ, то переходите к шагу 4
{% endhint %}

1. В Telegram свяжитесь с представителем PayPlay ([@payplay\_partnership](https://t.me/payplay_partnership) либо [@payplay\_operations](https://t.me/payplay_operations)) -> отправьте запрос на регистрацию и получение доступа к аккаунту PayPlay. **Подробнее о запросе в выпадающем списке ниже.**&#x20;

<details open>

<summary>Необходимая информация в запросе</summary>

• Название обменного пункта\
• Ссылку на обменный пункт\
• Адрес почты\
• Ожидаемый объем в месяц на депозит (в USDT эквиваленте)

</details>

2. [Зайдите](https://crm.payplay.io/login) в ЛК Payplay - раздел "[**Платежные страницы**](#user-content-fn-1)[^1]" -> нажмите "[**Создать страницу**](#user-content-fn-2)[^2]" -> на открывшейся странице, укажите "**Slug**" (к примеру, название вашего обменного пункта), "**URL веб-сайта**" в формате `https://www.exchanger.com/` и остальные обязательные поля -> нажмите "**Создать**".&#x20;
3. В ЛК PayPlay, нажмите на раздел "**Настройки**" - "[**Токены**](#user-content-fn-3)[^3]" -> на открывшийся странице, в разделе "**Ключ API**" нажмите "[**Создать**](#user-content-fn-4)[^4]" -> скопируйте [**API ключ**](#user-content-fn-5)[^5] в надежное место, **он также понадобится при настройке модуля выплаты**.
4. Зайдите в админ панель скрипта -> страница "**Мерчант и API**" -> в разделе "**MERCHANT SYSTEM**", нажмите на значок настроек в блоке с мерчантом PayPlay. \
   На странице настроек мерчанта PayPlay [**скопируйте**](#user-content-fn-6)[^6] ссылку "**IPN URL**".
5. Вернитесь в ЛК PayPlay, на страницу настроек вашей платежной страницы, которую вы создали на шаге 2 -> передите в раздел "[**Вебхуки**](#user-content-fn-7)[^7]" - вставьте "**IPN URL**" из шага 3 в поле "**Webhook-адрес**" - нажмите "[**Сохранить**](#user-content-fn-8)[^8]" -> [**скопируйте**](#user-content-fn-9)[^9] "**Webhook-токен**" в надежное место -> в разделе "**Настройка вебхуков**" - колонка "**Транзакции**" поставьте галочки напротив:\
   \- `Обмен транзакции завершен`\
   \- `Транзакция заморожена AML`\
   \- `Транзакция инициирована`\
   -> и нажмите "[**Сохранить**](#user-content-fn-10)[^10]".
6. Перейдите в админ панель скрипта на страницу настроек мерчанта PayPlay -> в поле "**Slug**" укажите значение "**Slug**" из шага 2 (вы также можете найти ваш Slug в ЛК PayPlay, на странице настроек вашей платежной страницы - раздел "**Главное**" поле "[**Slug**](#user-content-fn-11)[^11]")  -> нажмите "**Save**" -> в поле "**API Token**" укажите **API ключ** из шага 3 -> нажмите "**Save**" -> в поле "**Webhook Token**" укажите значение "**Webhook-токен**" из шага 5 - нажмите "**Save**" -> для поля "**Redirect Link or Display Address**" выберите формат отображения адреса (**Подробнее в таблице ниже)** -> нажмите "**Save**".

| Display Address                                    | Redirect Link                                                                                         |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Отображение адреса для депозита на странице заявки | Перенаправление клиента на страницу оплаты PayPlay и отображение адреса для депозита на этой странице |

### &#x20;Дополнительные настройки

{% endstep %}

{% step %}

* **Debug log** - передача дополнительных логов команде BoxExchanger.  В случае трудностей при работе модуля, установите значение "**Yes**" -> "**Save**" и обратитесь к поддержке BoxExchanger.
  {% endstep %}
  {% endstepper %}

[^1]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FMFSqkmDPqWv9VGLAMBaY%2Fimage.png?alt=media\&token=a246ba8e-78fc-49e1-9bf1-2148142ba319)

[^2]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FyJOq07VW6N3vK4p0hELR%2Fimage.png?alt=media\&token=8b5e68a9-ef72-4bbe-b908-5e8c9909620b)

[^3]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FNh527uPZwlBeOM1g9bpM%2Fimage.png?alt=media\&token=98973594-ffac-4375-ae9d-f45d5037e71f)

[^4]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FrmYMGQ5B9DjThFNhxn0g%2Fimage.png?alt=media\&token=12bb7cfa-3bc5-4a5b-8183-beb59bedd5ca)

[^5]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2Fevdt3Kzp5wHWscWPgX33%2Fimage.png?alt=media\&token=166bb045-7616-4a1f-afbe-093ab07c1337)

[^6]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2F4hCR947dqEgup4K1rWKr%2Fimage.png?alt=media\&token=327e7fef-4392-4588-b779-e5783c9a74f6)

[^7]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2F0wJCnpWLOggle5O5sxQG%2Fimage.png?alt=media\&token=31364a79-5660-4699-9eb1-790ec662f726)

[^8]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FZovBa7iEwNc1pakhvIbt%2Fimage.png?alt=media\&token=bfa856bb-f32a-4161-95db-70c98b1ba5d5)

[^9]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FXLAszPpSHUQXoHOul945%2Fimage.png?alt=media\&token=cd6f31c3-53d2-4a92-966d-28c5f6a4fe4d)

[^10]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FaE8ieFEU3TTUTPSHUnJH%2Fimage.png?alt=media\&token=07897266-8df5-41f9-95d5-31603fe882f1)

[^11]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2Fp3OACoLhyT2vM1RRgbiN%2Fimage.png?alt=media\&token=9357c4df-90b1-48b5-8894-e54006d3cde4)
