> 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 Инструкция по настройке мерчанта CryptoCash {% stepper %} {% step %} ## Установка мерчанта Используя параметры ниже, установите мерчант через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin.md).
Параметры для Install Plugin **Plugin type**: **`Merchant module`** **Plugin URL**: **`@boxexchanger-plugins/merchant-crypto-cash`** **Directory path**: **`crypto-cash`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% 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), будет происходить автоматический пересчет заявки, если переплата со стороны клиента в пределах допустимого процента переплаты. * **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]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FLDsqGI8McdqHBd0KY4Ko%2Fimage.png?alt=media\&token=92b94150-0caf-47a6-9f48-a8219652b78d) [^2]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FtV7XGOWlnm9gKh9cK1OL%2Fimage.png?alt=media\&token=aa7b29e0-39fb-43c2-becc-bd52b2be0f28) [^3]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2F6vBcSzyQy02eJEVIuTWh%2Fimage.png?alt=media\&token=740e7d80-0c80-4871-ad50-86fb6ca6f700) [^4]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FLFggfSixMloNTptFVNLk%2Fimage.png?alt=media\&token=3957be1b-86bb-4678-9b40-78810ab6c8e1) [^5]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FQ5ANxqRA6URo8BUY5SsG%2Fimage.png?alt=media\&token=5583d9cf-df85-4618-bf98-fe418a8b463d) [^6]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FZaQK2pCgXP9AADnAlM4t%2Fimage.png?alt=media\&token=31e77418-21de-4293-8611-1b82d217a417) [^7]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FaYi3QLRl4expIFQA2Ktf%2Fimage.png?alt=media\&token=563b7fdf-7bda-4470-8905-f5cc62d24e3f)