Сценарии интеграции
Платёжная страница
Что видит клиент на странице оплаты Ketmus и как настроить возврат на ваш сайт.
Платёжная страница по адресу pay_url — готовый интерфейс оплаты: выбор монеты и сети, адрес с QR-кодом, точная сумма, таймер и статус платежа в реальном времени. Она адаптирована под мобильные устройства и встроенный браузер Telegram.
Возврат на ваш сайт
| Параметр | Когда используется |
|---|---|
success_url | Автоматический переход после успешной оплаты |
fail_url | Переход, если счёт истёк или отменён |
return_url | Кнопка «Вернуться в магазин» на странице оплаты |
Если параметры не переданы в запросе, используются значения из настроек магазина.
Как открывать страницу
- Перенаправьте клиента (HTTP 303) или откройте
pay_urlв новой вкладке. - Встраивание в
iframeне поддерживается — из соображений безопасности страница оплаты не открывается внутри чужих сайтов. - В Telegram используйте inline-кнопку с URL или
Telegram.WebApp.openLink.
Выбор монет
По умолчанию клиент видит все монеты, включённые в настройках магазина. Чтобы показать только часть, передайте rails, а чтобы сразу открыть оплату в конкретной монете — rail.