На странице

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

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

Тестовый режим позволяет проверить интеграцию целиком: тот же 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, что и реальная транзакция, поэтому код сверки остаётся единым.

Симуляция депозитов канала

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

POST/v1/sandbox/payment-channels/:payment_channel_id/simulate-deposit

Тело: { "amount": "100", "currency": "USDT", "network": "TRC20", "stage": "confirmed" } — stage принимает значения confirming, reorged или confirmed, по умолчанию confirmed. Подписывайте ключом Payment из песочницы; ключ рабочей среды отклоняется до того, как что-либо будет создано. Каждый вызов сначала отправляет payment_channel.deposit.confirming, затем терминальное событие запрошенной стадии, поэтому обработчик вебхуков одинаков в песочнице и в рабочей среде. Полный контракт — в Симуляции депозита канала.