> 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/cryptocash/merchant-cryptocash.md).

# Мерчант CryptoCash

{% 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-crypto-cash`**</mark>

**Directory path**: <mark style="color:orange;">**`crypto-cash`**</mark>

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

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

</details>
{% endstep %}

{% step %}

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

{% hint style="info" %}
В случае, если вы уже зарегистрировались в CryptoCash и сгенерировали, а также сохранили значения "**Public key**" и "**Private key**" из ЛК CryptoCash, то перейдите к шагу 3.
{% endhint %}

1. [**Зарегистрируйтесь**](#user-content-fn-1)[^1] в CryptoCash по [ссылке](https://account.crypto-cash.world/registration) -> [войдите](https://account.crypto-cash.world/login) в ЛК.
2. Зайдите в админ панель скрипта -> страница "**Мерчант и API**" -> в разделе "**MERCHANT SYSTEM**", нажмите на значок настроек в блоке с мерчантом CryptoCash. \
   На странице настроек мерчанта CryptoCash, скопируйте значения ["**Public IP**" и "**Callback URL**"](#user-content-fn-2)[^2], они понадобятся на следующем шаге.
3. В ЛК CryptoCash, на странице "**Главная**" - в блоке "**Настройки**" нажмите "[**К настройкам**](#user-content-fn-3)[^3]" -> в модальном окне нажмите "[**Сгенерировать API ключ**](#user-content-fn-4)[^4]" и выберите "[**ED25519**](#user-content-fn-5)[^5]" -> на следующем шаге, в поле "**Имя ключа**" укажите название ключа -> в поле "**URL вебхука**" укажие значение "**Callback URL**" из шага 2 -> активируйте ползунок "**Ограничение по IP**" и укажите значение "**Public IP**" в поле для ввода -> в блоке "**Доступы к endpoints**" выберите:\
   \- Пополнение\
   \- Баланс\
   \- История транзакций\
   -> скопируйте значения ["**Секретный ключ**" и "**Публичный ключ**"](#user-content-fn-6)[^6] в надежное место  -> нажмите "[**Создать**](#user-content-fn-7)[^7]".

{% hint style="info" %}
Обратите внимание, что значения "**Секретный ключ**" и "**Публичный ключ**" также понадобятся для настройки [Выплаты CryptoCash](/obmen/merchant-i-api/cryptocash/vyplaty-cryptocash.md) и [CryptoCash модули](/dopolnitelnye-sistemy/cryptocash-moduli.md). Сохраните секретный ключ в надежном месте, пока модули CryptoCash не будут настроены. **В противном случае вам придется пересоздавать** "**Секретный ключ**" **так как после перезагрузки страницы ключ будет скрыт в целях безопасности.**
{% endhint %}

4. В админ панель скрипта BoxExchanger, на странице настроек мерчанта CryptoCash, в поле "**Public Key**" укажите значение "**Публичный ключ**" из шага 3 -> нажмите "**Save**" -> в поле "**Secret Key**" укажите значение "**Секретный ключ**" из шага 3 -> нажмите "**Save**" -> для поля "**Deposit Processing Mode**" укажите "**Webhook**" -> нажмите "**Save**" -> для поля "**Signature Type**" укажите "**ED25519**" -> нажмите "**Save**".
   {% endstep %}

{% step %}

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

* **API URL** - ссылка для API запросов CryptoCash. В случае, если у CryptoCash изменится ссылка для API запросов, то в поле "**API URL**" вы можете указать новую ссылку -> нажать "**Save**".
* **Payment with QR-code** - отображение QR-кода с адресом для оплаты. Для отображения QR-кода, выберите значение "**Yes**" -> нажмите "**Save**".
* **Over paid limit in %** - допустимый процент переплаты со стороны клиента. К примеру, если вы установите значение "**1**" -> нажмете "**Save**", то при переплате больше 1% для заявки будет установлен статус [Статусы заявки](/zayavki/zayavki/statusy-zayavki.md#oshibka-oplaty).\
  В связке с модулем [Approve underpaid orders](/dopolnitelnye-sistemy/approve-underpaid-orders.md), будет происходить автоматический пересчет заявки, если переплата со стороны клиента в пределах допустимого процента переплаты.&#x20;
* **Deposit Processing Mode** - способ получения информации о статусе депозита на адрес, сгенерированный CryptoCash.
  * Automatic check (cron) - получение информации о статусе депозите через API запросы к CryptoCash
  * Webhook (рекомендуется) - получение информации о статусе депозита по webhook от CryptoCash. При условии, что в API ключе CryptoCash указан Callback URL и в настройках мерчанта выбрана данная опция, на странице заявки будет отображаться актуальное и необходимое количество подтверждений сети текущего депозита.
* **Signature Type** - тип подписи для API запросов и webhook.
  * ED25519 (рекомендуется) - современный тип подписи, его необходимо выбирать в случае, если при создании API ключа в ЛК CryptoCash вы выбрали ED25519.
  * Legacy - устаревший тип подписи, его необходимо выбирать в случае, если при создании API ключа в ЛК CryptoCash вы выбрали Legacy.
* **Debug log** - передача дополнительных логов команде BoxExchanger. В случае трудностей при работе модуля, установите значение "**Yes**" -> "**Save**" и обратитесь к поддержке BoxExchanger.
  {% endstep %}
  {% endstepper %}

[^1]: ![](/files/Y9xd5i6ifUoInNDnTf4q)

[^2]: ![](/files/VFoHiRMpdUaLB1ivaGvv)

[^3]: ![](/files/6VwjriUL2aqydmJB7f7D)

[^4]: ![](/files/FbcvAc6l8tw4VWDv6ZYR)

[^5]: ![](/files/KJ34ALDREAj5WJZIWXtT)

[^6]: ![](/files/wQ2puQ7yPLX2CHa4IZtx)

[^7]: ![](/files/98N6feJztS8JYzCER62b)