# INXY Payments

## Регистрация

После регистрации в сервисе [https://auth.inxy.io/ ](<https://auth.inxy.io/ >)необходимо перейти в меню Payment gateway API и заполнить следующие данные:

1. Имя и описание кошелька, иконка.&#x20;
2. Ссылка на сайт ставится по вашему желанию.&#x20;

Все принимаемые виды криптовалют следует отметить галочками и нажать Save Changes

<figure><img src="/files/rN0EoiL21FxKjI5oVsCW" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/xeBoHI7UarHwDUa19XcM" alt=""><figcaption></figcaption></figure>

После сохранения откроется поле с данными для связи.&#x20;

Далее сгенерируйте Api ключ, нажатием кнопки Generate(1) и введите код, присланный вам на почту.&#x20;

Полученную переменную стоит сохранить в надежное место. Туда же скопируйте секретный ключ Secret Key.&#x20;

{% hint style="success" %}
Ключи, в случае потери, можно будет перегенерировать(если такое случится, не забудьте поменять данные в проекте).&#x20;
{% endhint %}

В поле Postback Url (2) надо указать url для вебхуков <https://chatter.salebot.pro/inxy\\_callback/result>

<figure><img src="/files/YjOvXA0vVGQanFMk5Dc1" alt=""><figcaption></figcaption></figure>

## Настройка подключения&#x20;

Затем переходим в Salebot → раздел "Эквайринг" → INXY и нажмите <mark style="background-color:blue;">**подключить**</mark>. Вводим в поля полученные Апи и Секретный ключи.

<figure><img src="/files/XrCOILrAF6MO9CgV3DEm" alt=""><figcaption><p>Раздел "Эквайринг" в Salebot</p></figcaption></figure>

<figure><img src="/files/KMGQKJQdi2yBP6sYF6Pa" alt=""><figcaption><p>Настройка INXY в разделе "Эквайринг" Salebot</p></figcaption></figure>

## Генерация ссылки на оплату

Для генерации ссылки на оплату Вам необходимо установить значение переменной payment\_sum (например, 1), после этого появится переменная inxy\_pay\_url. Эту переменную можно вывести на экран ссылкой или разместить в кнопке "Оплатить".

{% hint style="warning" %} <mark style="color:red;">**ОБРАТИТЕ ВНИМАНИЕ!!!**</mark> Система работает с долларами! Указанная сумма  в payment\_sum воспримется платежной системой INXY как доллары.
{% endhint %}

Ссылка имеет вид: [https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1 ](https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1)

Также, **до установки значения переменной payment\_sum**, можно задать следующие **необязательные переменные** для настройки платежа:\
**inxy\_currency** - криптовалюта, в которой будет проводиться оплата.&#x20;

{% hint style="info" %}
Можно указать одну из возможных криптовалют, которую Вы отметили галочкой при создании Апи ключа. Если оставить пустым, тогда плательщик сам выберет криптовалюту из тех, что были отмечены.&#x20;
{% endhint %}

Доступные значения: 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'

<figure><img src="/files/4HewHNcVJbTHz1nPzIhg" alt=""><figcaption></figcaption></figure>

**inxy\_description** – описание платежа.

<figure><img src="/files/LriWDbfb9nU80u720ak6" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:red;">**Обратите внимание**</mark>! Сначала задаются дополнительные переменные для настроек, затем payment\_sum.
{% endhint %}

Переменные можно задать и ранее в цепочке, а не всё в одном блоке. А переменную inxy\_pay\_url, в которой содержится ссылка, вывести в нужном месте. При переходе по ней откроется платежная форма.

<figure><img src="/files/Z5PCxRqH8zRVCXu0ROt0" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:red;">**Обратите внимание!**</mark> В строке total amount находится значение в долларах, равное payment\_sum. Ниже в total crypto amount - значение в выбранной криптовалюте. Оно меняется часто в зависимости от текущего курса. Именно это значение клиент должен оплатить Вам со своего кошелька.&#x20;
{% endhint %}

<figure><img src="/files/nMxovKfxQbKkMyRzbDSO" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:red;">**Обратите внимание!!!**</mark> Адрес кошелька для оплаты, в рамках одной сессии, резервируется за клиентом только на 2 часа. Рекомендуйте клиенту убедиться, что время не истекло и адрес кошелька актуальный на момент оплаты. Если время сессии закончилось, то необходимо заново начать процесс оплаты.
{% endhint %}

## Обработка результата оплаты (callback об оплате)

После успешной оплаты в бот придёт callback , по которому вы сможете понять, что была успешная оплата. Этот callback в системе Вы видите как сообщение от пользователя, чтобы их не мог отправить пользователь этот callback НЕ ВИДИТ сам пользователь, он отображается только оператору. У INXY есть несколько типов коллбэков:

1. Успешные коллбэки состоят из 10 первых символов токена и приписки success, например: uc8zsjNN1x\_success

<figure><img src="/files/1oNA0ZLIR7SKyqZD6pIl" alt=""><figcaption><p>Коллбэк об успешной оплате в диалоге с клиентом</p></figcaption></figure>

Такой callback приходит, если клиент полностью оплатил сумму, и не возникло никаких проблем при оплате. Вместе с этим коллбэком в переменные проекта добавится переменная **inxy\_payment\_completed** , равная True. А также переменная **inxy\_payment\_status** примет значение paid&#x20;

{% hint style="warning" %}
Переменная inxy\_payment\_status может менять свое значение на протяжении всего периода обработки платежа. После того, как пользователь откроет форму, она примет статус waiting\_payment, во время обработки его платежа она примет значение waiting\_confirmation, а после успешной обработки будет значение paid или partially\_paid
{% endhint %}

При обработке коллбэка тип сравнения должен быть "Полное совпадение".&#x20;

Например, можно сделать обработку успешной оплаты блоком с условием и вывести соответствующее сообщение пользователю:

<figure><img src="/files/hViU7R9gcLIQq1XoOFht" alt=""><figcaption></figcaption></figure>

2\. Бывают ситуации, когда курс крипты поменялся или кошелек снял комиссию с операции, в результате чего к вам на счет поступила неполная сумма. В таком случае переменная inxy\_payment\_status примет значение partially\_paid и в систему придет коллбэк вида

<figure><img src="/files/NUvWCCiAUvMUNzwE4noe" alt=""><figcaption></figcaption></figure>

В данном случае Вам нужно будет отправить клиенту уведомление с просьбой о доплате.&#x20;

Например, можно поставить условие на начало коллбэка и при его получении вновь отправить клиенту уже сгенерированный url со ссылкой на оплату или же поставить условие, что блок срабатывает, когда переменная inxy\_payment\_status равна partially\_paid.

<figure><img src="/files/w048EMykTvRRa8MrYD9u" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Помните, что ссылка для оплаты действительна **только 2 часа**! Если клиент не успеет оплатить оставшуюся часть, открыть ее будет уже нельзя. Поскольку INXY на данном этапе уже обработает первый неполный платеж, деньги клиенту не вернутся. Для их возвращения потребуется перейти в личный кабинет INXY и провести операцию возврата.
{% endhint %}

## Создание подписки

В системе INXY доступно создание подписок. Для этого стоит присвоить любое значение переменной **inxy\_subscription\_payment**, и тогда создастся ежемесячная подписка.&#x20;

Если Вы хотите указать другой период, воспользуйтесь следующими переменными: **inxy\_subscription\_interval** равная ‘day’ - задаст интервал, равный дням (по умолчанию стоит месяц) \
**inxy\_subscription\_period** - укажите переменную от 1 до 30, чтобы задать периодичность.&#x20;

Например, чтобы создать списание по подписке раз в 15 дней надо поставить inxy\_subscription\_interval =’day’ и inxy\_subscription\_period=15, а чтобы деньги списывались раз в полгода надо просто указать inxy\_subscription\_period=6 (т.к. inxy\_subscription\_interval по умолчанию равно месяц)

<figure><img src="/files/NssCJ1Fg9aC9TJll7L6R" alt=""><figcaption></figcaption></figure>

При переходе по ссылке будет та же самая платежка, однако с некоторыми изменениями: во-первых, сбоку будет указано, что оплата происходит по подписке с указанной периодичностью, а во-вторых, платежка предложит клиенту оплатить наперед две или три суммы.

{% hint style="warning" %}
**Особенность платежки INXY**: Если клиент оплатит х2 или х3 от суммы, в Salebot придет уведомление об оплате только одной из них. Остаток отправится на счет клиента, откуда в последующие списание и будет изъята сумма. Поскольку криптовалютный курс постоянно меняется, в итоге этой суммы может не хватить для последующего списания, отчего возникнет ситуация с неполностью оплаченной подпиской. Вам в таком случае придет коллбэк содержания “fail” и вы сможете настроить напоминание клиенту.
{% endhint %}

{% hint style="warning" %}
Частичной оплаты по расписанию быть не может. Перед оплатой проверяется баланс и если баланса недостаточно, списание денег со счета клиента **не происходит**.
{% endhint %}

<figure><img src="/files/54fUX35jgp3YuKTO94dR" alt=""><figcaption></figcaption></figure>

После успешного оформления подписки в переменных клиента появится переменная **inxy\_subscribtion\_id**, обозначающая номер подписки и **inxy\_subscription\_status** с ее статусом.

<figure><img src="/files/UaqaTMEkLr1UuidMq2nM" alt="" width="385"><figcaption></figcaption></figure>

## Отмена подписки

Чтобы отменить подписку, воспользуйтесь функцией **inxy\_remove\_subscription(inxy\_subscription\_id)**. Подставьте идентификатор подписки inxy\_subscribtion\_id в функцию, и подписка отменится.

<figure><img src="/files/NR4aXEY9mm3um33ufx6V" alt=""><figcaption></figcaption></figure>

В случае успеха Вам придет коллбэк **‘Статус подписки inxy\_subscription\_id - deleted’** и переменная **inxy\_subscription\_status** поменяется на соответствующее значение

<figure><img src="/files/tIp7ecHfMdmZSkZzG5sx" alt=""><figcaption></figcaption></figure>


---

# 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://docs.salebot.pro/integration/payments/inxy-payments.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.