На странице

Терминал

Используйте ссылку проекта как терминал на телефоне или планшете: введите сумму, покажите QR-код и дождитесь подтверждения.

Терминал — готовая страница оплаты для приёма крипты вживую. Открываете ссылку на телефоне или планшете, вводите сумму на нампаде, передаёте устройство клиенту. После оплаты страница автоматически возвращается к нампаду — готова к следующей транзакции.

Терминал не требует отдельной установки. Не требует кода, API-ключей в коде или серверной части. Все настройки (бренд, валюта, активные сети) наследуются из настроек проекта в Widget Builder.

Где взять URL терминала

Откройте Dashboard → Widgets.
Выберите проект, для которого нужен терминал.
Перейдите на вкладку Terminal.
Включите тумблер «Terminal enabled» для этого проекта.
Скопируйте POS URL в карточке.

URL имеет вид:

https://paymos.io/pos?key=pk_live_xxx&pid=prj_yyy

Поделитесь ссылкой с кассирами или сохраните в закладках браузера на устройстве у стойки.

Что в URL

Параметр	Назначение
`key`	Публичный ключ проекта (префикс `pk_live_` или `pk_test_`). Не секретный — но его обладание даёт право создавать инвойсы на ваш проект. Берётся из активного payment-ключа проекта.
`pid`	Идентификатор проекта (префикс `prj_`). Определяет какие токены, сети и брендинг загрузятся.

URL не привязан к устройству — открывается на любом девайсе с браузером. Каждое открытие — независимая сессия.

Как идёт продажа

01Кассир открывает URL терминала в браузере (телефон, планшет или PC).
02Выбирает фиатную валюту (USD, EUR, RUB и ещё 43) и вводит сумму на нампаде.
03Нажимает Оплатить — терминал создаёт инвойс и открывает стандартную страницу оплаты.
04Клиент платит со своего устройства: сканирует QR с экрана терминала или открывает ссылку.
05После подтверждения on-chain — терминал автоматически возвращается к нампаду.

Кассир не трогает кошелёк. Клиент не регистрируется в Paymos. Весь процесс — от 30 секунд до пяти минут в зависимости от сети.

Настройка внешнего вида

Терминал наследует те же brand-настройки что и обычная страница оплаты. Меняются в карточке Branding на Widgets → Checkout:

Настройка	Что меняет
Checkout style	Базовый стиль страницы оплаты (повторяющийся pattern, тема)
Accent color	Основной цвет: кнопки, ссылки, hover, индикатор активной сети
Background color	Фон страницы
Surface color	Поверхность карточек и панелей
Text color	Основной текст
Muted color	Приглушённый текст (подсказки, мелкие надписи)
Corner radius	Скругление углов кнопок и карточек, 0-32px

После сохранения настроек preview-iframe в Widget Builder обновится автоматически. Терминал увидит изменения при следующем открытии.

Логотип

Логотип проекта (задаётся через поле Logo URL в форме проекта) автоматически появляется в шапке терминала. Подходит любой URL картинки которую браузер откроет — PNG, SVG, JPEG, WebP.

Список валют

Терминал показывает валюты, включённые в проекте на вкладке Currencies. Стандартный набор для розницы — USD, EUR, RUB. Меняйте список под валюты, в которых принимаете оплату.

Активные сети и токены

Терминал показывает клиенту только те сети и токены, которые включены на вкладке Currencies проекта. Для типичной розничной точки оптимально:

Tron (USDT) — клиенты СНГ и Азии
Polygon (USDC/USDT) — низкая комиссия клиенту
BSC (USDT) — массовая аудитория Binance
TON — пользователи в экосистеме Telegram

Оставьте основную сеть Ethereum включённой, если ожидаете крупные чеки.

Тестовый и рабочий режим

URL терминала содержит префикс ключа: pk_test_ для тестового режима и pk_live_ для рабочего. В тестовом режиме в шапке отображается баннер «Sandbox mode».

Для тестирования:

Сгенерируйте pk_test_ ключ в Dashboard → Developers → API.
Сформируйте тестовый URL терминала в том же формате с ключом pk_test_.
Оплачивайте инвойсы из testnet-кошельков.

Для приёма реальных платежей создайте ключ pk_live_ и обновите URL у кассиров.

Если используете Widget SDK без фиксированной суммы (amount не передан), передайте URL терминала в параметре pos_url — тогда виджет откроет терминал вместо стандартной формы оплаты. Это позволяет одним виджетом покрыть два сценария:

С фиксированной суммой — клиент платит указанную сумму через стандартную форму.
Произвольная сумма — клиент сам вводит сумму через терминальный нампад.

Один скрипт, два режима, без отдельной сборки. Без pos_url перехода на терминал не будет: клик без суммы отдаёт событие paymos:error.

Несколько кассиров или устройств

URL — общий. Открывайте на скольких устройствах нужно — все работают параллельно с одним проектом. Транзакции пишутся в общую историю проекта; в дашборде видны все продажи.

Учёт по кассирам не встроен. Если нужна атрибуция кассы — заведите по проекту на кассу или по локации. Каждый проект — свой URL, своя история, своя сводка в дашборде.

Несколько локаций

Под каждую локацию — отдельный проект в Paymos:

Dashboard → Projects → Create.
Настройте брендинг и активные сети.
Включите Terminal и скопируйте URL для этой локации.

Все проекты под одним merchant-аккаунтом — отчётность агрегируется в общий дашборд.

Безопасность

key в URL — публичный ключ. Его наличие не даёт доступа к выводу средств, изменению настроек проекта или закрытым операциям. Но он даёт право создавать инвойсы на ваш проект.

Что это значит на практике:

URL терминала можно держать в публичных закладках устройства у стойки — это безопасно.
Если URL утёк постороннему — он может создавать инвойсы (но не оплачивать их за вас и не выводить средства).
При компрометации создайте новый pk_live_ ключ в Dashboard → Developers → API и обновите URL. Старый ключ отзовите.

Secret ключи (sk_live_) в терминал никогда не попадают. Они нужны только для серверных запросов в API.

Устранение неполадок