# Мерчант 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)


---

# 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://manual.boxexchanger.net/obmen/merchant-i-api/cryptocash/merchant-cryptocash.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.
