Документация API

Изучите Merchant API Paymos для счетов, балансов по токенам, подписанных вебхуков и выводов в 13 поддерживаемых блокчейн-сетях.

Создайте проект, выпустите платёжный ключ, подпишите первый запрос счёта, откройте страницу оплаты и проверьте итоговый вебхук.

Проследите путь счёта от создания и выбора актива до обнаружения платежа, подтверждения, истечения срока и итогового вебхука.

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

Подписывайте каждый запрос Merchant API по HMAC-SHA256: обязательные заголовки, каноническая строка, метка времени и защита от повторов.

Создавайте платёжные и расходные API-ключи, разбирайтесь в правах и префиксах, безопасно меняйте секреты и разделяйте тестовый и рабочий доступ.

Используйте единый базовый URL Merchant API для тестовых и реальных платежей: режим определяется префиксом ключа, а пути не меняются.

Проверьте, в каких из 13 блокчейн-сетей доступны USDT, USDC, USD1, DAI и обеспеченный золотом XAUT, прежде чем включать активы.

Обрабатывайте ошибки Merchant API единообразно: формат ответа, группы HTTP-статусов, машинные коды, лимиты запросов и правила повторов.

Обрабатывайте ошибки Merchant API по стабильным машинным кодам, деталям валидации полей и документированным сценариям восстановления.

Получайте время сервера Paymos перед подписью запросов и безопасно компенсируйте расхождение часов.

Создание платёжного инвойса для приёма криптовалютных платежей. Два потока: прямой крипто (токен указан) и фиатный (клиент выбирает токен на странице оплаты).

Получайте список счетов со строгими фильтрами по статусу и датам и проходите результаты курсором без повторения страниц.

Фиксируйте токен и сеть для счёта с ценой в фиатной валюте из собственного интерфейса и безопасно показывайте реквизиты оплаты.

Получайте счёт по идентификатору, проверяйте состояние оплаты и подтверждения и надёжно сверяйте ответ со своим номером заказа.

Отменяйте открытый счёт до фиксации актива клиентом, учитывайте допустимый переход состояния и корректно обрабатывайте ответ API.

Переводите тестовый инвойс в выбранный платёжный результат и проверяйте тот же жизненный цикл и вебхуки, что при подтверждённой транзакции.

Создавайте вывод с баланса токена на кошелёк из белого списка, выбирайте сеть, подписывайте запрос и отслеживайте состояние.

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

Получайте вывод по идентификатору, проверяйте его состояние и ссылку на транзакцию и сверяйте завершение по подписанному вебхуку.

Отменяйте ожидающий вывод до начала MPC-подписи, учитывайте допустимые состояния операции и обрабатывайте обновлённый ответ API.

Завершайте ожидающий тестовый вывод без отправки транзакции и проверяйте payout-вебхуки от начала до конца.

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

Подключите Paymos к своему backend через подписанные webhook-endpoint'ы с разделением по окружениям и полным контролем доставки.

Обрабатывайте все 13 webhook-событий Paymos с явным состоянием ресурса и понятной терминальностью.

Разбирайте версионированный webhook-envelope и полный снимок инвойса или выплаты в поле data.

Проверяйте заголовок X-Webhook-Signature по HMAC-SHA256, безопасно сравнивайте подпись, контролируйте время и меняйте секрет без простоя.

Учтите 11 попыток доставки вебхука примерно за 16 часов, отсекайте повторы, разбирайте ошибки и повторяйте событие после восстановления.

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

Установите официальный плагин Paymos для WooCommerce, безопасно подключите проект, проверьте оплату и обновление заказа по вебхуку.

Добавьте стейблкоины в счета WHMCS, подключите настроенный пакет Paymos, проверьте вебхук и сохраните существующие правила активации услуг.

Установите официальное расширение Paymos для OpenCart, подключите магазин без копирования секретов и проверьте статусы в тестовом режиме.

Подключите Paymos к Easy Digital Downloads, проведите тестовую покупку, проверьте подписанный вебхук и выдавайте файл после подтверждения.

Установите официальное дополнение Paymos для CS-Cart и Multi-Vendor, подключите проект, проверьте статусы по вебхуку и проведите тестовый заказ.

Установите модуль Paymos для Magento 2 или Adobe Commerce, подключите ключи двух режимов и проверьте переход заказа в оплаченный статус.

Установите плагин Paymos для Shopware 6, включите его в канале продаж, проверьте подписанные статусы и смените режим без переустановки.

Добавьте Paymos в PrestaShop 8 или 9, скачайте настроенный модуль, проверьте подписанный вебхук и переход заказа в Payment accepted.

Перенаправляйте клиента на страницу оплаты или встраивайте её в защищённый iframe, а заказ исполняйте после подписанного вебхука.

Добавьте на страницу настраиваемую кнопку оплаты, выберите источник суммы и оформление и откройте Paymos без собственной формы.

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

Используйте официальные клиенты Merchant API для JavaScript/TypeScript, Python, PHP, Go, .NET, Java, Ruby и Rust с типизированными запросами и HMAC.

Узнайте, как Paymos защищает балансы токенов с помощью MPC-подписи 2 из 3, HMAC-аутентификации, подписанных вебхуков и аудита.