---
title: Пісочниця
description: Пісочниця Coinetic: той самий API, сторінка оплати й вебхуки без реальних грошей. Тестові платежі USDT, USDC і Bitcoin кнопками та з автотестів.
url: https://coinetic.money/uk/docs/sandbox/
lang: uk
---

# Пісочниця

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

| Що | Адреса |
| --- | --- |
| API | `https://sandbox.coinetic.money` |
| Кабінет | [https://sandbox.coinetic.money/merchant](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` (докладніше в розділі [«Повернення»](https://coinetic.money/uk/docs/refunds/)).

## Відмінності від продакшену

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

## Що прогнати перед запуском

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