Перейти к содержимому

Интеграции

На странице

Терминал

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

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

Терминал не требует установки: ни кода, ни API-ключей в коде, ни серверной части. Оформление, список валют и активные сети терминал берёт из настроек проекта.

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

Терминал доступен проекту, который создан со способом подключения «Терминал». Способ выбирается один раз, при создании, и потом не меняется — под другой сценарий заводится отдельный проект.

Страница терминала в дашборде — /terminal. Ссылка лежит там в карточке «Доступ к терминалу», поле «URL терминала». Рядом — предпросмотр: видно ровно то, что откроется у кассира.

URL имеет вид:

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

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

Прежний адрес /pos продолжает работать: он переадресует на /terminal вместе с параметрами, поэтому сохранённая закладка на стойке открывает терминал как раньше. Новым кассирам выдавайте /terminal.

Что в URL

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

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

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

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

Кассир не трогает кошелёк. Клиент не регистрируется в Paymos. Дольше всего идёт подтверждение в сети: там, где сеть даёт финальность сразу — BSC, Polygon, Solana, Avalanche, Plasma, — это секунды, а крупный чек в сети с подтверждениями по глубине ждёт дольше.

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

Терминал использует то же оформление, что и обычная страница оплаты. Настройки — в карточке «Брендинг» на странице «Форма оплаты» (/checkout-form в дашборде):

Настройка Что меняет
Стиль страницы оплаты Базовый пресет: фоновый узор и тема
Акцент Основной цвет: кнопки, ссылки, наведение, индикатор активной сети
Фон Фон страницы
Поверхность Поверхность карточек и панелей
Текст Основной текст
Приглушённый Подсказки и мелкие надписи
Скругление Скругление углов кнопок и карточек, 0–32 px

После сохранения предпросмотр на этой же странице обновится сразу. Терминал подхватит изменения при следующем открытии.

Логотип проекта появляется в шапке терминала сам — отдельной настройки для терминала нет. Загружают его на странице самого проекта: Проекты → откройте нужный проект. Это загрузка файла с устройства; поля со ссылкой на картинку нет.

Форматы — PNG, JPEG и WebP, размер файла — до 2 МБ. SVG не принимается.

Список валют

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

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

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

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

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

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

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

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

  1. Сгенерируйте ключ pk_test_ в Дашборд → Разработчик → API-ключи.
  2. Сформируйте тестовый URL терминала в том же формате с ключом pk_test_.
  3. Закрывайте инвойс вызовом POST /v1/sandbox/invoices/:invoice_id/simulate-payment — в тестовом режиме транзакции симулируются, кошелёк и монеты тестовой сети не нужны.

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

Терминал как запасной сценарий виджета

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

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

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

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

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

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

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

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

  1. Дашборд → Проекты → Создать — способ подключения выберите «Терминал».
  2. Настройте брендинг и активные сети.
  3. Скопируйте URL терминала этого проекта.

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

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

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

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

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

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

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

Терминал не открывается

Проверьте:

  1. URL содержит оба параметра — key и pid.
  2. Способ подключения проекта — «Терминал». У проекта с другим способом подключения терминала нет.
  3. Ключ не отозван — раздел Разработчик → API-ключи.

Страница пишет «Оплата недоступна»

Один экран на три причины: у проекта другой способ подключения, ключ или pid не подходят, ключ отозван. Сверьте URL с полем «URL терминала» в дашборде, а способ подключения — с настройками проекта.

Не появляется QR после нажатия «Оплатить»

Терминал пишет «Не удалось создать счёт» — инвойс не создался. Проверьте, включён ли в проекте хотя бы один токен на вкладке «Валюты». Вторая причина — ключ из URL отозвали, пока вкладка была открыта: откройте терминал заново по актуальному URL.

Отдельное сообщение «Ошибка соединения» означает другое: устройство потеряло сеть, нажмите «Оплатить» ещё раз.

Оплата не подтверждается

Время подтверждения зависит от сети и суммы инвойса. Актуальная политика видна в дашборде. Если статус долго не меняется, проверьте хеш транзакции в обозревателе выбранной сети.

Терминал выглядит сломанным после смены темы

Во вкладке осталось старое оформление из кэша. Закройте вкладку и откройте URL заново.

Low-Code SDK для JavaScript Серверные SDK