Документация / Начало

Песочница

Отдельный экземпляр Coinetic без реальных сетей. API, подписи, страница оплаты, статусы и вебхуки с повторами работают как в продакшене — только платежи имитируются.

Что	Адрес
API	`https://sandbox.coinetic.money`
Кабинет	https://sandbox.coinetic.money/merchant

Ключи песочницы и продакшена — разные. Ключ песочницы на продакшене не работает, и наоборот.

Тестовые платежи кнопками

На странице оплаты песочницы, после выбора валюты, есть блок «Песочница: тестовая оплата»:

Кнопка	Что происходит
Оплатить точно	Платёж на полную сумму: сразу `detected`, через ~3 с `paid`
Недоплата 10%	90% суммы → `underpaid`
Доплатить остаток	(после недоплаты) остаток → `paid`
Переплата 10%	110% → `overpaid`
Половина суммы	50%; нажмите ещё раз — вторая половина → `paid`

Тестовые платежи из автотестов

Те же сценарии — запросом. Токен — часть checkout_url после #t=. Валюта должна быть уже выбрана (на странице или POST /v1/invoices/{id}/select с тем же токеном).

HTTP

POST /sandbox/v1/invoices/{id}/pay
Authorization: Bearer <токен из checkout_url после #t=>
Content-Type: application/json

{"scenario": "exact"}

Значения scenario: exact, underpay, overpay, half, rest.

Возврат в песочнице исполняется одной командой — POST /v1/refunds/{id}/simulate (подробнее в разделе «Возвраты»).

Отличия от продакшена

В счетах и вебхуках livemode: false. Продакшен-магазин должен отвергать такие счета и события — так ошибочно подключённая песочница не выдаст товар.
Вебхуки и return_url можно направить на http://localhost и http://127.0.0.1. Публичные адреса — только https:// и порт 443, как в продакшене.
Проверка AML всегда «чистая».
Курсы волатильных активов — настоящие, с бирж.

Что прогнать перед запуском

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