Sandbox и тестовые сценарии
Sandbox это тестовый режим, как test mode у Stripe: интеграция проверяется целиком, без реальных денег и без ожидания блокчейна. Sandbox-приложение это приложение с флагом testnet (ставится при создании в кабинете), его ключи начинаются с pl_test_. Тестовое окружение Paylane: https://api-dev.paylane.pro/api/v1, кабинет https://app-dev.paylane.pro.
Деньги sandbox не смешиваются с боевыми. Инвойсы, платежи, балансы и выводы sandbox-приложения помечены testnet: true и живут на отдельных счетах леджера и тестовых сетях. Комиссии sandbox идут на отдельный счёт оператора и выручкой не считаются: оператор их не выводит. Токен sandbox-приложения не видит боевые данные, боевой токен не может вызвать /sandbox/... (403 LIVE_MODE).
Оплата без перевода. POST /sandbox/invoices/{id}/pay или кнопка «Симулировать оплату» на странице pay_url (стрелка рядом открывает остальные сценарии). Платёж проходит по сети sim: Paylane кладёт перевод в уже подтверждённый блок, дальше работает обычный код, поэтому статусы, балансы и вебхуки такие же, как в бою, и подписаны так же. Ответ приходит сразу в статусе paying, итог через секунду. Если сеть у инвойса не выбрана, выбирается sim. Для инвойса в настоящей тестовой сети (Nile, devnet) сценарии недоступны (NOT_AVAILABLE): там платите тестовыми монетами из faucet.
scenario | Что происходит | Статус инвойса | Вебхуки |
|---|---|---|---|
paid (по умолчанию) | Перевод остатка суммы | paid | invoice_paying, invoice_paid |
underpaid | Перевод половины остатка (ниже допуска недоплаты) | partially_paid, при allow_partial: false снова active | invoice_paying, invoice_partially_paid |
overpaid | Остаток плюс 10 % | overpaid, излишек в overpaid_amount | invoice_paying, invoice_paid |
expired | Срок инвойса истекает сейчас | expired | invoice_expired |
dropped | Перевод замечен, потом выпал из блока (reorg) | paying, затем снова active | invoice_paying |
late | Срок истекает, потом приходит полная оплата | expired, при accept_late становится paid | invoice_expired, payment_late (или invoice_paid) |
Сценарии комбинируются: underpaid, затем paid доплачивает остаток. expired и late ждут, пока подтвердится уже отправленный перевод (PAYMENT_IN_FLIGHT).
Вебхуки. Sandbox-вебхуки уходят тем же конвейером, с тем же порядком доставки, повторами и подписью, что и боевые. Для проверки обработчика: POST /sandbox/events генерирует событие любого типа, POST /webhooks/{update_id}/resend присылает уже отправленное событие ещё раз. В sandbox webhook_url может быть http://; до ноутбука вебхук доходит через туннель (rift, ngrok и т. п.).
Выводы в sandbox работают как в бою, но без ручной проверки, AML и лимитов: на тестовых сетях настоящими транзакциями, в sim переводом в симулированной сети.