INXY payments
Реєстрація
Після реєстрації в сервісі https://auth.inxy.io/ перейдіть у меню API платіжного шлюзу та заповніть таку інформацію:
Назва та опис гаманця, іконка.
Посилання на сайт розміщується на ваш запит.
Потрібно відмітити всі прийнятні типи криптовалют і натиснути Зберегти зміни
Після збереження відкриється поле даних для зв’язку.
Далі згенеруйте API-ключ, натиснувши Generate(1), і введіть код, надісланий на вашу електронну пошту.
Отриману змінну слід зберігати в безпечному місці. Також скопіюйте туди Secret Key.
У разі втрати ключі можна згенерувати повторно (якщо це станеться, не забудьте змінити дані в проєкті).
У полі Postback Url (2) вкажіть url для вебхуків https://chatter.salebot.pro/inxy_callback/result
Налаштування підключення
Потім перейдіть у Mavibot → розділ "Acquiring" → INXY і натисніть connect. Введіть отримані API та Secret keys у відповідні поля.
Генерування платіжного посилання
Щоб згенерувати платіжне посилання, потрібно встановити значення змінної payment_sum (наприклад, 1). Після цього з’явиться змінна inxy_pay_url. Цю змінну можна відобразити як посилання або розмістити в кнопці "Pay".
УВАГА!!! Система працює з доларами! Вказана сума в payment_sum буде прийнята платіжною системою INXY як долари.
Посилання має вигляд: https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1
Також, перед встановленням значення змінної payment_sum, ви можете задати такі додаткові змінні для налаштування платежу: inxy_currency — криптовалюта, в якій буде здійснено платіж.
Ви можете вказати одну з доступних криптовалют, які ви відмітили під час створення API-ключа. Якщо залишити поле порожнім, платник сам обере криптовалюту з-поміж позначених..
Доступні значення: 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'
inxy_description — опис платежу
Зверніть увагу! Спочатку для налаштувань задаються додаткові змінні, потім payment_sum.
Змінні можна задавати раніше в ланцюжку, а не всі в одному блоці. А змінну inxy_pay_url, яка містить посилання, слід відобразити в потрібному місці. Після натискання на неї відкриється форма оплати.
Зверніть увагу! Рядок із загальною сумою містить значення в доларах, яке дорівнює payment_sum. Нижче в рядку загальної суми в криптовалюті — це значення у вибраній криптовалюті. Воно часто змінюється залежно від поточного курсу. Саме цю суму клієнт має сплатити вам зі свого гаманця.
Увага!!! Адреса гаманця для оплати в межах однієї сесії резервується для клієнта лише на 2 години. Рекомендуйте клієнту переконатися, що час не минув і адреса гаманця є актуальною на момент оплати. Якщо час сесії сплив, потрібно буде розпочати процес оплати заново.
Обробка результату платежу (payment callback)
Після успішної оплати в бота буде надіслано callback, який повідомить, що платіж успішно виконано. Ви бачите цей callback у системі як повідомлення від користувача, щоб користувач не міг їх надсилати. Сам користувач ЦЕЙ callback НЕ БАЧИТЬ, він відображається лише оператору. INXY має кілька типів callback:
Успішні callback складаються з перших 10 символів токена та постфікса success, наприклад: uc8zsjNN1x_success
Цей callback надходить, якщо клієнт повністю оплатив суму і з оплатою немає проблем. Разом із цим callback, inxy_payment_completed змінна буде додана до змінних проєкту, і для неї буде встановлено значення True. А також inxy_payment_status змінна набуде значення paid.
Змінна inxy_payment_status може змінювати своє значення протягом усього періоду обробки платежу. Після відкриття форми користувачем вона набуде статусу waiting_payment, потім під час обробки його платежу — значення waiting_confirmation, а після успішної обробки матиме значення paid або partially_paid.
Під час обробки callback тип порівняння має бути "Exact 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' — встановлює інтервал у днях (за замовчуванням це місяць) inxy_subscription_period — вкажіть значення від 1 до 30, щоб задати частоту.
Наприклад, щоб створити списання за підпискою раз на 15 днів, потрібно встановити inxy_subscription_interval =’day’ і inxy_subscription_period=15, а щоб платіж списувався кожні шість місяців, достатньо вказати inxy_subscription_period=6 (оскільки за замовчуванням inxy_subscription_interval — місяць)
Переходячи за посиланням, користувач побачить ту саму платіжну сторінку, але з кількома відмінностями: по-перше, збоку буде примітка, що платіж є частиною підписки із зазначеною періодичністю; і по-друге, платіжна сторінка запропонує клієнту можливість сплатити дві або три суми наперед.
Особливості платіжної системи INXY: Якщо клієнт сплачує x2 або x3 від суми, Mavibot отримає повідомлення про оплату лише однієї з них. Решта суми буде зарахована на баланс клієнта, звідки вона буде списуватися під час наступних дебетів. Оскільки курс криптовалюти постійно змінюється, у результаті цієї суми може не вистачити для наступного списання, що призведе до ситуації з неповністю оплаченою підпискою. У такому разі ви отримаєте callback “fail” і зможете налаштувати нагадування для клієнта.
Часткова оплата за графіком неможлива. Баланс перевіряється перед оплатою, і якщо балансу недостатньо, кошти не будуть списані з рахунку клієнта.
Після успішної підписки, inxy_subscription_id з’явиться у змінних клієнта, вказуючи номер підписки, а inxy_subscription_status — її статус.
Скасування підписки
Щоб скасувати підписку, використайте функцію inxy_remove_subscription(inxy_subscription_id). Вставте в функцію ID підписки inxy_subscription_id, і підписка буде скасована.
У разі успіху ви отримаєте callback «Статус підписки inxy_subscription_id — видалено» та inxy_subscription_status змінна зміниться на відповідне значення.
Останнє оновлення