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 у відповідні поля.

скрін на підключення з Salebot

Генерація платіжного посилання

Щоб згенерувати платіжне посилання, введіть значення змінної payment_sum (наприклад: 1), після цього з’явиться змінна inxy_pay_url. Ви можете додати цю змінну на екран як посилання або вставити її в кнопку Pay.

УВАГА! Система працює з USD! Сума у змінній payment_sum вважається сумою в USD у платіжній системі 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. Callback успіху складаються з перших 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). Введіть ідентифікаційний номер підписки як inxy_subscribtion_id у функції, і підписку буде скасовано.

У разі успіху ви отримаєте callback ‘Subscription status inxy_subscription_id - deleted’, а змінна inxy_subscription_status зміниться на відповідне значення.