Підключення платіжної системи
Підключення з боку Telegram
Крок 1. Увійдіть у свій партнерський акаунт
На сторінці, що відкрилася, натисніть "Увійти через Telegram", потім введіть свій номер телефону у спливаючому вікні "З'являється oauth.telegram.org" і натисніть "Застосувати".
Необхідно підключити платіжну систему як через веб-браузер, так і через додаток:
- Ви отримаєте запит на авторизацію в Telegram — натисніть "Застосувати".
- Також потрібно натиснути "Застосувати" у спливаючому вікні "oauth.telegram.org" у веб-браузері.
Рекомендується використовувати акаунт, до якого має доступ особа, відповідальна за фінанси. Для юридичних осіб – уповноважений представник.
Крок 2. Пройдіть невелике опитування
Якщо ви входите вперше або вам потрібна додаткова інформація, WalletPay пропонує відповісти на кілька запитань, щоб отримати більш детальну інформацію. Є два етапи:
1. Анкета
2. Перевірки KYB (Know Your Business) або KYC (Know Your Customer)
Після завершення вашу заявку буде розглянуто найближчим часом, і вас повідомлять про результати. У разі успіху ви побачите комісію, яку стягує сервіс, і отримаєте доступ до свого акаунта, де зможете розпочати інтеграцію.
Для юридичних осіб форму може заповнювати лише довірена особа: директор або працівник за довіреністю.
Крок 3. Створіть перший "Магазин".
Після успішного проходження "Опитування" вам буде запропоновано створити перший магазин.
Крок 4. Створіть "API ключ"
Після назви першого магазину вам буде запропоновано його налаштувати:
- Згенеруйте API ключ.
- Скопіюйте ваш API ключ і почніть інтеграцію з Mavibot.
Крок 5. Створіть замовлення та отримайте платіжне посилання
Якщо ви хочете розмістити посилання в кнопці, використовуйте Inline Button.
Зверніть увагу, що лише вказаний "customerTelegramUserId" може відкрити сторінку оплати.
Крок 6. Виведення коштів
Після підтвердження оплати клієнтом кошти зараховуються на ваші активи та утримуються протягом 48 годин за замовчуванням. Після цього часу ви зможете вивести кошти на баланс вашого Wallet, який ви використовували для входу в сервіс Paypal Wallet.
Крок 7. Повернення коштів
Наразі виведення коштів доступне з вашого акаунта Wallet, який ви використовуєте для входу в WalletPay. Але незабаром це буде доступно у вашому Merchant акаунті.
Як виглядає кнопка оплати?
Під час інтеграції вашого Telegram Bot з "Wallet Pay API" переконайтеся, що кнопка оплати відповідає наступним рекомендаціям:
- Названа одним із двох способів:
- 👛 Wallet Pay
- 👛 Pay via Wallet
- Розташована над іншими кнопками (якщо вони є).
Примітка. 👛 — це смайлик (див. https://emojipedia.org/purse/).
Дивіться приклад у [Demo Store Bot].
Підключення до Mavibot
Увійдіть у проект і натисніть кнопку “Connect” для Wallet Pay у розділі “Payment systems”.
У вікні, що відкрилося, введіть API ключ, згенерований для вашого магазину WalletPay.
- Готово! Тепер клієнти можуть оплачувати покупки у вашому магазині криптовалютами (USDT, Toncoin та Bitcoin) за допомогою сервісу Paypal Wallet.
Як згенерувати платіжне посилання
Створіть блок конструктора воронок і викличте функцію “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, а продавець отримує зворотний виклик у вигляді 4690FE98_success, який складається з:
- “4690FE98” — це перші 8 символів API ключа Wallet Pay.
- слова про успіх
! якщо сталася помилка оплати, ви отримаєте зворотний виклик із суфіксом “_fail”.
Адреса для сповіщень (зворотних викликів): https://chatter.salebot.pro/wallet_pay/payment_callback — вставляється в налаштування платіжної системи
Зворотний виклик можна вбудувати в умову блоку, щоб надіслати клієнту повідомлення про успішну оплату (або помилку оплати):
Якщо ви не хочете вибивати клієнта з основної схеми чат-бота, використовуйте блок "Non state condition". Ви не можете перейти до цього блоку, тому клієнт не виб'ється з основної воронки після оплати та отримає сповіщення про успішну оплату.
омление об успешной оплате.А якщо вам потрібно продовжити воронку з реакцією на успішну оплату, то використовуйте блок "Start condition", тоді клієнт перейде з блоку оплати до блоку "Start condition", з якого ви зможете продовжити воронку.
Більше інформації про умовні блоки наведено в однойменній статті. посиланняблоках с условием рассказали