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

Начало работы

На странице

Тестирование

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

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

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

Параметр Тестовый режим Рабочий режим
Base URL api.paymos.io/v1 api.paymos.io/v1
API-ключи pk_test_ / rk_test_ ID + sk_test_ секреты pk_live_ / rk_live_ ID + sk_live_ секреты
Транзакции Симулированные Реальный блокчейн
Вебхуки Отправляются Отправляются
Средства Без реальной стоимости Реальная крипта

Симуляция платежей

Тестовые платежи не подтверждаются автоматически — запускайте симуляцию явно:

POST/v1/sandbox/invoices/:invoice_id/simulate-payment

Тело: { "stage": "paid" }, где stage — одно из paid, overpaid, underpay, cancel. Подпишите запрос как любой вызов /v1. Метод работает только для тестовых счетов; ключ рабочего режима получает 403 not_sandbox. Жизненный цикл и события вебхука совпадают с реальным платежом в блокчейне, поэтому обработчик остаётся единым для обоих режимов.

Симуляция выводов

Тестовые выводы не отправляют транзакцию в сеть. Пометьте ожидающий тестовый вывод как завершённый, чтобы проверить процесс целиком:

POST/v1/sandbox/withdrawals/:withdrawal_id/simulate-completion

Тело запроса не требуется. Подпишите вызов ключом для вывода; метод работает только для тестовых операций. Он переводит вывод в completed и отправляет тот же вебхук withdrawal.completed, что и реальная транзакция, поэтому код сверки остаётся единым.

Тестирование вебхуков локально

Откройте доступ к локальному серверу через туннель:

ngrok http 3000

Укажите webhook URL в Дашборд → Разработчикам → Вебхуки:

https://abc123.ngrok.io/api/paymos-webhook

Webhook playground

В документации есть Webhook Playground — он работает только в тестовом режиме и отправляет полностью подписанное событие на ваш зарегистрированный URL. Удобно отлаживать проверку подписи, не создавая инвойс.

  • 01В тестовом режиме перейдите в Панель → Разработчикам → Документация
  • 02Откройте раздел Вебхуки → Тестирование, затем вкладку Playground
  • 03Выберите тип события (invoice.paid, invoice.expired, withdrawal.completed и т.д.) и нажмите Send
  • 04Проверьте логи сервера на полученное событие и заголовок X-Webhook-Signature

Чеклист перед запуском

  • Проверка подписи вебхуков работает
  • Создание инвойсов возвращает корректные данные
  • Платёжный процесс корректно перенаправляет
  • Обработка ошибок покрывает ответы со статусом не 2xx (валидация 4xx, конфликты 409)
  • Идемпотентность с external_order_id работает
  • Заменить API key ID с pk_test_ / rk_test_ на pk_live_ / rk_live_, а secrets с sk_test_ на sk_live_