Тестовый контур #
Отдельный путь /sandbox/v1/..., изолированный от боевого: нет базы, нет денег, состояние живёт в памяти и исчезает при перезапуске. Авторизация не нужна — Authorization и подпись можно не слать.
Только приём (collect). Выплат, вывода и тестовых ключей на /gw/v1 нет.
POST /sandbox/v1/collect #
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
merchant_reference | string | нет | Ваш номер заказа, возвращается как есть |
amount_minor | int64 | да | Сумма > 0. Последние две цифры выбирают сценарий, см. таблицу |
currency | string | да | Любая непустая строка |
method | string | да | C2C (карта) или SBP — те же значения, что в бою. Старые card/sbp пока принимаются, в ответе всё равно будет C2C/SBP |
notify_url | string | нет | HTTPS-адрес коллбека по этой заявке. Пусто — уведомлений не будет |
Запрос
{
"merchant_reference": "test-1",
"amount_minor": 100001,
"currency": "RUB",
"method": "C2C",
"notify_url": "https://example.com/webhooks/sandbox"
}201
{
"reference": "sbxcol_01J8ZD5E6F7G8H9J0K1L2M3N4P",
"merchant_reference": "test-1",
"status": "accepted",
"amount_minor": 100001,
"currency": "RUB",
"method": "C2C",
"created_at": "2026-09-23T10:00:00Z",
"updated_at": "2026-09-23T10:00:00Z",
"webhook_secret": "5f3c8d1a9b7e4a2c8f6d0b3e7a1c9d5f...",
"scenario": "instant_success"
}| Поле | Описание |
|---|---|
webhook_secret | Секрет подписи коллбеков этой заявки: 64 шестнадцатеричных символа. Декодируйте в 32 байта и считайте HMAC ими — как и в бою. Показывается один раз |
scenario | Какой сценарий выбран по сумме — подсказка для отладки |
Остальные поля — как в бою, см. «Приём средств».
Пределы. Песочница открыта без ключа и живёт в памяти, поэтому:
| Что | Предел |
|---|---|
merchant_reference | до 128 символов |
currency | до 8 символов |
notify_url | до 2048 символов |
| Тело запроса | до 4 КиБ; больше — 413 REQUEST_TOO_LARGE |
| Заявок в памяти | 5 000 на всю песочницу, самые старые вытесняются раньше суток |
| Одновременных доставок коллбеков | 64; лишние события не отправляются (повторов в песочнице нет) |
Лимит запросов считается по IP, для IPv6 — по подсети /64.
Ошибки: 400 INVALID_ARGUMENT (amount_minor <= 0, пустая currency, method не C2C/SBP, непригодный notify_url, поле длиннее предела), 413 REQUEST_TOO_LARGE (тело больше 4 КиБ), 429 RATE_LIMITED (~20 запросов/с на IP), 503 UNAVAILABLE (песочница не собрана в этом окружении).
GET /sandbox/v1/collect/{reference} #
200 — ровно тот же формат, что у боевого GET /gw/v1/collect/{reference}, включая requisite при awaiting_payment. webhook_secret и scenario здесь не возвращаются.
Ошибки: 404 NOT_FOUND (нет такой заявки; доигранные заявки удаляются через сутки).
Реквизиты заведомо фиктивны: карты начинаются с 9990 (BIN, не выданный ни одной платёжной системе, контрольная цифра Луна настоящая), телефоны СБП — с +70000, bank_code всегда sandbox_bank, держатель — IVAN TESTOV.
Сценарии: исход выбирает сумма #
Сценарий = amount_minor % 100 (последние две цифры).
| Код | Сценарий | Путь заявки |
|---|---|---|
01 | instant_success | accepted → awaiting_payment → fulfilled, почти сразу |
02 | slow_success | То же, но с заметной паузой перед fulfilled |
10 | declined_no_executor | accepted → declined, decline_reason: no_executor_available |
11 | declined_by_executor | accepted → awaiting_payment → declined, decline_reason: executor_rejected |
20 | lapsed | accepted → lapsed |
40 | dispute_upheld_fulfilled | fulfilled → disputed → fulfilled |
41 | dispute_reversed | fulfilled → disputed → reversed |
42 | dispute_upheld_declined | declined → disputed → declined |
43 | dispute_overturned_to_fulfilled | lapsed → disputed → fulfilled |
| любой другой | instant_success | Обычная сумма — рабочий happy path |
Пример: amount_minor = 100011 запустит declined_by_executor, 5041 — dispute_reversed. Прогоните сценарий 11 обязательно: исполнитель отказался уже ПОСЛЕ выдачи реквизита — в бою это случается, и интеграции этот путь чаще всего не обрабатывают.
Паузы между шагами — секунды, а не боевые минуты. Опрашивайте статус раз в одну-две секунды, если не слушаете коллбек.
Коллбек песочницы #
Если задан notify_url, каждый переход статуса шлёт подписанный POST — той же схемой подписи, что в бою («Уведомления»), но секретом служит webhook_secret из ответа на создание.
Отличия от боевой доставки:
| Бой | Песочница | |
|---|---|---|
| Повторы | 6 попыток по расписанию | Нет: не ответили 2xx — событие потеряно |
| Заголовки | X-GGWPay-Signature, -Event-Id, -Event-Type, -Timestamp | Те же |
| Тело | event_type, occurred_at, data | Те же |
| Адрес | Регистрируется на аккаунт | Поле notify_url у каждой заявки |