Skip to main content
Новое в 1.4.0 Песочница — режим сайта (не отдельный сервер): оператор включает его в админке (Сайт → «Изменить» → «Интеграция» → Песочница). После этого:
  • депозиты и выплаты сайта не выходят в сеть — адреса генерируются, но мониторинг чейна и broadcast для них отключены;
  • входящие транзакции и исходы выплат вы эмулируете двумя вызовами Public API (ниже);
  • всё остальное штатное: статусы, окно доплаты, допуск недоплаты, лимиты и одобрение выплат, возвраты, настоящие вебхуки с тем же контрактом и подписью — плюс поле sandbox: true в теле и заголовок X-Sandbox: true в каждом ответе Public API сайта.
Заведите два сайта — боевой и sandbox — с разными API-ключами. CMS переключается только ключами.

​
Эмулировать входящую транзакцию

uuid — депозита (из POST /v1/public/deposits) или статического адреса (каждый вызов — отдельный платёж).
​
string
Сумма «пришедшей» транзакции. По умолчанию — ожидаемая сумма депозита. Больше — paid_over, меньше — wrong_amount (или ожидание доплаты, если она включена).
​
string
Адрес отправителя в эмулируемой транзакции (по умолчанию sandbox). Полезно для проверки возвратов.
​
integer
Подтверждений на момент детекции. По умолчанию — порог финализации: депозит сразу paid. Меньше порога — депозит останется в process (deposit.tx_detected), финализация придёт автоматически через ~30 секунд.
Ответ 200
Синтетический txhash начинается с sandbox: и в сети не существует; explorerTxUrl для него бессмысленен.

​
Задать исход выплаты

​
string
required
confirmed — выплата проходит queued → signing → broadcasted → confirmed с синтетическим txhash; failed — failed с причиной.
​
string
Причина для failed.
Выплата должна быть в queued. Если по правилам одобрения она в pending_approval — сначала одобрите её в админке (четыре глаза работают и в песочнице), либо отключите одобрение для тестового сайта. Выплата-возврат депозита завершает и сам депозит (refund_paid / refund_fail).

​
Ошибки

​
Что не эмулируется

Балансы hot-кошельков (/v1/public/balances) — реальные; комиссии сети — оценки по живым оракулам; AML-проверки идут по реальным провайдерам (для sandbox-адресов вернут «чисто»); свип и JIT-ликвидность пропускаются. Уведомления операторам (Telegram) приходят как обычно — используйте отдельный тестовый сайт.