На странице
Тестирование
Проверяйте состояния счетов и выводов с тестовыми ключами, подписанными вебхуками и методами симуляции без движения реальных средств.
Тестовый режим позволяет проверить интеграцию целиком: тот же 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_ секреты |
| Транзакции | Симулированные | Реальный блокчейн |
| Вебхуки | Отправляются | Отправляются |
| Средства | Без реальной стоимости | Реальная крипта |
Симуляция платежей
Тестовые платежи не подтверждаются автоматически — запускайте симуляцию явно:
Тело: { "stage": "paid" }, где stage — одно из paid, overpaid, underpay, cancel. Подпишите запрос как любой вызов /v1. Метод работает только для тестовых счетов; ключ рабочего режима получает 403 not_sandbox. Жизненный цикл и события вебхука совпадают с реальным платежом в блокчейне, поэтому обработчик остаётся единым для обоих режимов.
Симуляция выводов
Тестовые выводы не отправляют транзакцию в сеть. Пометьте ожидающий тестовый вывод как завершённый, чтобы проверить процесс целиком:
Тело запроса не требуется. Подпишите вызов ключом для вывода; метод работает только для тестовых операций. Он переводит вывод в 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_