Wallet pay
Підключення платіжної системи
Підключення зі сторони Telegram
Крок 1. Увійдіть у свій партнерський акаунт
На сторінці, що відкриється, натисніть «Log in via Telegram», потім введіть свій номер телефону у спливаючому вікні «oauth.telegram.org» і натисніть «Apply».
Потрібно підключити платіжну систему і через веббраузер, і через застосунок:
Ви отримаєте повідомлення в Telegram із запитом на авторизацію — натисніть «Apply».
Також потрібно натиснути «Apply» у спливаючому вікні «oauth.telegram.org» у веббраузері.
Рекомендується використовувати акаунт, до якого має доступ відповідальний за фінанси. Для юридичних осіб — уповноважений представник.
Крок 2. Пройдіть коротке опитування
Якщо ви входите вперше або вам потрібна додаткова інформація, WalletPay пропонує відповісти на кілька запитань, щоб отримати детальніші відомості. Є два етапи:
1. Анкета
2. Перевірки KYB (Know Your Business) або KYC (Know Your Customer)
Після завершення вашу заявку незабаром буде розглянуто, і ви отримаєте повідомлення з результатами. У разі успіху ви побачите комісію, яку стягує сервіс, і отримаєте доступ до свого акаунта, де зможете почати інтеграцію.
Для юридичних осіб форму може заповнити лише довірена особа: директор або співробітник за довіреністю.
Крок 3. Створіть перший «Магазин».
Після успішного завершення «Опитування» вам буде запропоновано створити свій перший магазин.
Крок 4. Створіть «API key»
Після назви першого магазину вам буде запропоновано його налаштувати:
Згенеруйте API key.
Скопіюйте свій API key і почніть інтеграцію з Mavibot.
Крок 5. Створіть замовлення та отримайте посилання для оплати
Якщо хочете вставити посилання в кнопку, використовуйте Inline Button.
Зверніть увагу, що лише вказаний "customerTelegramUserId" може відкрити сторінку оплати.
Крок 6. Виведення коштів
Після того як клієнт підтвердить оплату, кошти зараховуються на ваші активи й за замовчуванням утримуються протягом 48 годин. Після цього ви зможете вивести кошти на баланс вашого Wallet, через який ви входили до сервісу Paypal Wallet.
Крок 7. Повернення коштів
Наразі виведення коштів доступне з вашого акаунта Wallet, який ви використовуєте для входу в WalletPay. Але незабаром це буде доступно у вашому акаунті Merchant.
Як виглядає кнопка оплати?
Під час інтеграції вашого Telegram-бота з «Wallet Pay API» переконайтеся, що кнопка оплати відповідає таким рекомендаціям:
Називається одним із двох способів:
:purse: Wallet Pay
:purse: Pay via Wallet
Розташована над іншими кнопками (якщо вони є).
Примітка. :purse: — це смайлик (див. https://emojipedia.org/purse/).
Дивіться приклад у [Demo Store Bot].
Підключення до Mavibot
Увійдіть у проєкт і натисніть кнопку «Connect» для Wallet Pay у розділі «Платіжні системи».
У вікні, що відкриється, введіть API key, згенерований для вашого магазину WalletPay.
Як сформувати посилання на оплату
Створіть блок конструктора воронки та викличте «wallet_pay_generate_payment_url» функцію в калькуляторі, передавши їй потрібні параметри:
amount
суму платежу в криптовалюті або іншій фіатній валюті, доступній для конвертації в «TON».
сurrency_code
Валюта платежу за замовчуванням — «RUB». Список доступних валют: «TON» «BTC» «USDT» «EUR» «USD» «RUB»
description
короткий опис замовлення від 5 до 100 символів.
timeout_seconds
Термін дії посилання в секундах, за замовчуванням — 3600 секунд.
Коли блок спрацьовує у чаті з ботом, клієнт отримає платіжне посилання, а wallet_pay_payment_completed у клієнта буде створено змінну зі значенням False.
Це посилання можна відкрити лише в чаті з ботом, підключеним до білінгового акаунта WalletPay.
Перевірка платежу
Після успішної оплати значення змінної клієнта wallet_pay_payment_completed буде встановлено в True, а продавець отримає callback у вигляді 4690FE98_success, який складається з:
«4690FE98» — це перші 8 символів API key Wallet Pay.
слова про успішно
! якщо сталася помилка платежу, ви отримаєте callback із суфіксом «_fail».
Адреса для сповіщень (callbacks): https://chatter.salebot.pro/wallet_pay/payment_callback - вставляється в налаштуваннях платіжної системи
Callback можна вбудувати в умову блоку, щоб надіслати клієнту повідомлення про успішний платіж (або помилку платежу):
Якщо ви не хочете вибивати клієнта з основної схеми чат-бота, використовуйте блок «Умова без стану». До цього блоку не можна перейти, тож клієнт не буде вибитий з основної воронки після оплати й отримає сповіщення про успішну оплату.
А якщо вам потрібно продовжити воронку з реакцією на успішну оплату, тоді використовуйте блок «Початкова умова», після чого клієнт перейде з блоку оплати до блоку «Початкова умова», з якого ви зможете продовжити воронку.
Докладніше про умовні блоки йдеться в однойменній статті. посиланняу блоках з умовою розповіли
Корисні посилання
Останнє оновлення