INXY Payments

Криптопроцессинговая платформа с рекуррентными функциями

Регистрация

После регистрации в сервисе https://auth.inxy.io/ перейдите в Payment gateway API в левом боковом меню и заполните следующие данные — название и описание кошелька, а также иконку. Ссылка на ваш сайт необязательна. Отметьте все криптовалюты, которые хотите принимать, галочками и нажмите Save Changes

После сохранения откроется окно с данными подключения. Далее сгенерируйте API key, нажав кнопку Generate (1), и введите код, отправленный на вашу электронную почту. Сохраните полученное значение в надежном месте. Скопируйте сгенерированный Secret Key туда же. Ключи, в случае утери, можно сгенерировать заново (в этом случае не забудьте изменить данные в проекте). Введите URL для вебхуков https://chatter.salebot.pro/inxy_callback/result в поле Postback URL (2).

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

Затем перейдите в Salebot — Платежные системы — INXY и нажмите кнопку Connect. Введите полученные API & Secret keys в соответствующие поля.

скрин на подключение из Salebot

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

Чтобы сгенерировать платежную ссылку, введите значение переменной payment_sum (например: 1), после этого появится переменная inxy_pay_url. Вы можете добавить эту переменную на экран как ссылку или вставить ее в кнопку Pay.

ВАЖНО! Система работает с USD! Сумма в переменной payment_sum считается суммой в долларах США в платежной системе INXY.

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

Также, перед вводом суммы для переменной payment_sum, вы можете ввести следующее дополнительные переменные для настройки платежа inxy_currency — криптовалюта, которая будет использоваться для оплаты. Вы можете указать одну из доступных криптовалют, которые вы выбрали галочками при генерации API key. Если оставить поле пустым, игроки сами выберут криптовалюту из списка выбранных. Доступные значения: ‘BTC’,‘ETH’,‘LTC’,‘DOGE’,‘USDT’,‘USDC’,‘DAI’

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

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

Переменные можно вводить раньше в цепочке, а не в одном блоке. При этом переменная inxy_pay_url, содержащая ссылку, должна быть выведена в нужном месте. Эта ссылка открывает форму оплаты.

ВАЖНО! Строка Total amount показывает значение в USD, которое равно payment_sum. Ниже строка Total crypto amount показывает значение в выбранной криптовалюте. Оно меняется в зависимости от текущего курса. Это сумма, которую ваш клиент должен заплатить вам со своего кошелька.

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

Платежный callback

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

1. Success callbacks состоят из первых 10 символов токена, за которыми следует ‘success’, например: uc8zsjNN1x_success

Такой callback отправляется, если клиент оплатил полную сумму и во время оплаты не возникло проблем. Вместе с этим callback в проект будут добавлены две переменные: inxy_payment_completed = True; и inxy_payment_status с оплаченной суммой.

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

При обработке callback тип сравнения должен быть Full match. Например: вы можете оформить успешную обработку платежа как блок с условием и показать пользователю соответствующее сообщение:

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

В этом случае вам нужно отправить клиенту сообщение с просьбой доплатить недостающую сумму. Например: вы можете задать условие для начала вашего callback и после его получения отправить клиенту заранее сгенерированный url со ссылкой на оплату, либо можно задать условие, при котором блок активируется, когда значение переменной inxy_payment_status partially_paid.

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

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

Система INXY позволяет пользователям создавать подписки. Для этого добавьте любое значение в inxy_subscription_payment переменную, и будет создана ежемесячная подписка. Если вы хотите задать другой период, используйте следующие переменные: inxy_subscription_interval равное ‘day’ — создаст интервал подписки, равный дням (по умолчанию — month) inxy_subscription_period — добавьте переменную со значением от 1 до 30, чтобы задать период. Например, чтобы создать подписку с оплатой раз в 15 дней, задайте inxy_subscription_interval =‘day’ и inxy_subscription_period=15, а для оплаты два раза в год — inxy_subscription_period=6 (так как по умолчанию inxy_subscription_interval равен month)

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

Особенности INXY: Если клиент оплатит х2 или х3 от суммы, Salebot получит сообщение об одной сумме. Остальное будет зачислено на баланс клиента и будет использовано для последующих платежей. Так как курс криптовалюты меняется, в итоге этой суммы может не хватить для одного из следующих платежей, что приведет к неоплаченной подписке. В таком случае вы получите callback со статусом ‘fail’ и сможете настроить напоминание для вашего клиента.

Подписку нельзя оплатить частично. Баланс клиента проверяется перед платежом. Если средств недостаточно, платеж вообще не будет проведен.

После успешной подписки в переменные клиента будут добавлены inxy_subscribtion_id (номер ссылки) и inxy_subscription_status.

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

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

В случае успеха вы получите callback ‘Subscription status inxy_subscription_id - deleted’, а переменная inxy_subscription_status изменится на соответствующее значение.