Документація / Початок

Пісочниця

Окремий екземпляр 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-ключа без простою.