# Мерчант Heleket

{% hint style="info" %}
Инструкция содержит аннотации с иллюстрациями описанных шагов. Нажмите на текст, подчеркнутый пунктиром, чтобы увидеть аннотацию.
{% endhint %}

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

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

<details>

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

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

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

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

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

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

</details>

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

1. [**Зарегистрируйтесь**](#user-content-fn-1)[^1] на Heleket по [ссылке](https://dash.heleket.com/signup) -> войдите в ЛК -> подключите 2FA в настройках аккаунта - раздел "**Security**" - "[**Two-Factor Authentication**](#user-content-fn-2)[^2]".&#x20;
2. В хедере нажмите "**Businnes**" -> "**Merchants**" -> на открывшейся странице нажмите на кнопку "[**Create merchant**](#user-content-fn-3)[^3]" -> в появившемся модальном окне, введите имя мерчанта -> нажмите "[**Create merchant**](#user-content-fn-4)[^4]" -> после успешного создания мерчанта, в модальном окне нажмите "[**Go to setup**](#user-content-fn-5)[^5]".&#x20;
3. На странице мерчанта, в правом верхнем углу нажмите "[**Merchant settings**](#user-content-fn-6)[^6]" -> на странице "**Merchant Settings**", в разделе "**API Integration**" нажмите "[**Leave a request**](#user-content-fn-7)[^7]" для того чтобы оставить заявку на активацию мерчанта.
4. На открывшейся странице, на шаге "**Choose type and add project URL"** выберите "**Website**" -> в поле "**Project URL**" введите URL вашего сервиса в формате `https://example.com` -> в поле "**Project name**" введите имя вашего сервиса -> нажмите "[**Submit**](#user-content-fn-8)[^8]".&#x20;
5. На шаге "**Confirm domain**" выберите удобный для вас способ подтверждения домена (ниже будет описан способ подтверждения домена с помощью DNS) -> выполните необходимые шаги по инструкции Heleket -> нажмите "Check" для проверки владения доменом -> нажмите "**Confirm Domain**" для завершения процесса.

{% hint style="info" %}
**Для подтверждения домена с помощью DNS**:

Для раздела "**Select the method to confirm the domain"** выберите "**Using DNS**" -> скопируйте значение для TXT записи -> добавьте значение в TXT запись домена (см. инструкцию ниже).

**Добавление записи в Cloudflare**:\
а) Зайдите в ЛК Cloudflare -> на странице "**Websites**" [**зайдите**](#user-content-fn-9)[^9] на страницу настроек вашего домена.\
б) Перейдите на страницу "**DNS**" -> "**Records**" -> нажмите "[**Add record**](#user-content-fn-10)[^10]" -> "**Type**" выберите "**TXT**" -> "**Name**" введите **`@`** -> в поле "**Content**" вставьте ранее скопированное значение -> нажмите "**Save**".
{% endhint %}

6. Дождитесь активации мерчанта со стороны Heleket -> [**скопируйте**](#user-content-fn-11)[^11] "**Merchant ID**" и "**Payment API key**" в надежное место.&#x20;
7. Зайдите в админ панель скрипта BoxExchanger - страница "**Мерчант AP**I" - Merchant system - [**настройки**](#user-content-fn-12)[^12] мерчанта Heleket.
8. В поле "**Merchant Id**" укажите значение "**Merchant ID**", скопированное на шаге 5 -> нажмите "**Save**" -> в поле "API Key" укажите значение "**Payment API key**" из шага 5 -> нажмите "[**Save**](#user-content-fn-13)[^13]" -> скопируйте ваш **PUBLIC IP**.&#x20;
9. Перейдите на страницу настроек ЛК Heleket - раздел "**Business settings**" либо по [ссылке](https://dash.heleket.com/settings/business-settings/api-whitelist) -> включите "**API’s whitelist**" -> добавьте, скопированный на шаге 7, IP адрес в список доверенных IP-адресов.
10. Готово. Мерчант Heleket настроен.

[^1]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FNOFHW9lERHXJ29SOG5i1%2Fimage.png?alt=media\&token=d2ebad47-23cb-4aed-b86e-aa724be13f7b)

[^2]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FSxtcRZO13yNkwBDV5o86%2Fimage.png?alt=media\&token=7ac3bbfd-4a74-4024-96a8-edeeaf437a6a)

[^3]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FH9eqPdfvaNdSfFaeuJAP%2Fimage.png?alt=media\&token=b1b3a7b7-e1f9-4033-8ce5-95f24d3cac4b)

[^4]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FShifOGyR4x4UWvA66UNi%2Fimage.png?alt=media\&token=739f8725-4f57-45c3-b543-74f6d2fe4152)

[^5]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FqvkVRbd81Cib6RLmb9F1%2Fimage.png?alt=media\&token=38757ec5-71ac-4a25-8616-9f4e5ca9c876)

[^6]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2Ff5LNUI1WvcrB5I8pAhIo%2Fimage.png?alt=media\&token=2a3f99f9-752a-49df-8efb-f479544605a5)

[^7]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2F7OpccsEkwQBROvZiqoZH%2Fimage.png?alt=media\&token=da971797-2bb9-47e6-b723-975500644590)

[^8]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FaJ7KjlBZ11eGR4n6EOiY%2Fimage.png?alt=media\&token=c8dccf31-3864-4ae9-9b85-2e576ea430c8)

[^9]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FcXLcjHcItG9eCq9UoBaZ%2Fimage.png?alt=media\&token=baa9d570-4169-49c6-80f2-66f68357851d)

[^10]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FfLUP7P3YfuvIHBc2p2Dh%2Fimage.png?alt=media\&token=b9ede628-8253-4496-85a3-9d25709beeb3)

[^11]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FJ1oBO7saIbJkfIXLnoYZ%2Fimage.png?alt=media\&token=88a47b49-8a0c-4971-a32e-bfed6c5000fd)

[^12]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FqsHfhdN0UhM1MrMIXH3h%2Fimage.png?alt=media\&token=3b1d9e21-21d8-49d0-8c18-ce6fdcf5fd1a)

[^13]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2Ftggr14DCGhilqqwNG9Y3%2Fimage.png?alt=media\&token=269ad9d8-56fb-4eb9-a639-2770dd058d07)
