INXY Payments

Платформа для криптопроцессинга с повторяющимися функциями

Регистрация

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

1. Имя и описание кошелька, иконка.

2. Ссылка на сайт ставится по вашему желанию.

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

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

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

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

Ключи, в случае потери, можно будет перегенерировать(если такое случится, не забудьте поменять данные в проекте).

В поле Postback Url (2) надо указать урл для вебхуков https://chatter.salebot.pro/inxy_callback/result

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

Затем переходим в Salebot -> платежные системы -> INXY и нажмите подключить. Вводим в поля полученные Апи и Секретный ключи.

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

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

ОБРАТИТЕ ВНИМАНИЕ!!! Система работает с долларами! Указанная cумма в payment_sum воспримется платежной системой INXY как доллары.

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

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

Можно указать одну из возможных криптовалют, которую Вы отметили галочкой при создании Апи ключа. Если оставить пустым, тогда плательщик сам выберет криптовалюту из тех, что были отмечены.

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

inxy_description – описание платежа.

Обратите внимание! Сначала задаются дополнительные переменные для настроек, затем payment_sum.

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

Обратите внимание! В строке total amount находится значение в долларах, равное payment_sum. Ниже в total crypto amount - значение в выбранной криптовалюте. Оно меняется часто в зависимости от текущего курса. Именно это значение клиент должен оплатить Вам со своего кошелька.

Обратите внимание!!! Адрес кошелька для оплаты, в рамках одной сессии, резервируется за клиентом только на 2 часа. Рекомендуйте клиенту убедиться, что время не истекло и адрес кошелька актуальный на момент оплаты. Если время сессии закончилось, то необходимо заново начать процесс оплаты.

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

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

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

Такой callback приходит, если клиент полностью оплатил сумму, и не возникло никаких проблем при оплате. Вместе с этим колбеком в переменные проекта добавится переменная inxy_payment_completed , равная True. А также переменная inxy_payment_status примет значение paid

Переменная inxy_payment_status может менять свое значение на протяжении всего периода обработки платежа. После того, как пользователь откроет форму, она примет статус waiting_payment, во время обработки его платежа она примет значение waiting_confirmation, а после успешной обработки будет значение paid или partially_paid

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

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

2. Бывают ситуации, когда курс крипты поменялся или кошелек снял комиссию с операции, в результате чего к вам на счет поступила неполная сумма. В таком случае переменная inxy_payment_status примет значение partially_paid и в систему придет колбек вида

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

Например, можно поставить условие на начало колбека и при его получении вновь отправить клиенту уже сгенерированный url с ссылкой на оплату или же поставить условие, что блок срабатывает, когда переменная inxy_payment_status равна partially_paid.

Помните, что ссылка для оплаты действительна только 2 часа! Если клиент не успеет оплатить оставшуюся часть, открыть ее будет уже нельзя. Поскольку INXY на данном этапе уже обработает первый неполный платеж, деньги клиенту не вернутся. Для их возвращения потребуется перейти в личный кабинет INXY и провести операцию возврата.

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

В системе INXY доступно создание подписок. Для этого стоит присвоить любое значение переменной inxy_subscription_payment, и тогда создастся ежемесячная подписка.

Если Вы хотите указать другой период, воспользуйтесь следующими переменными: inxy_subscription_interval равная ‘day’ - задаст интервал, равный дням(по умолчанию стоит месяц) inxy_subscription_period - укажите переменную от 1 до 30, чтобы задать периодичность.

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

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

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

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

После успешного оформления подписки в переменных клиента появится переменная inxy_subscribtion_id, обозначающая номер подписки и inxy_subscription_status с ее статусом.

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

Чтобы отменить подписку, воспользуйтесь функцией inxy_remove_subscription(inxy_subscription_id). Подставьте идентификатор подписки inxy_subscribtion_id в функцию, и подписка отменится.

В случае успеха Вам придет колбек ‘Статус подписки inxy_subscription_id - deleted’ и переменная inxy_subscription_status поменяется на соответствующее значение