GGWPAY docs

Тестовый контур #

Отдельный путь /sandbox/v1/..., изолированный от боевого: нет базы, нет денег, состояние живёт в памяти и исчезает при перезапуске. Авторизация не нужна — Authorization и подпись можно не слать.

Только приём (collect). Выплат, вывода и тестовых ключей на /gw/v1 нет.

POST /sandbox/v1/collect #

ПолеТипОбяз.Описание
merchant_referencestringнетВаш номер заказа, возвращается как есть
amount_minorint64даСумма > 0. Последние две цифры выбирают сценарий, см. таблицу
currencystringдаЛюбая непустая строка
methodstringдаC2C (карта) или SBP — те же значения, что в бою. Старые card/sbp пока принимаются, в ответе всё равно будет C2C/SBP
notify_urlstringнетHTTPS-адрес коллбека по этой заявке. Пусто — уведомлений не будет

Запрос

json
{
  "merchant_reference": "test-1",
  "amount_minor": 100001,
  "currency": "RUB",
  "method": "C2C",
  "notify_url": "https://example.com/webhooks/sandbox"
}

201

json
{
  "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 (последние две цифры).

КодСценарийПуть заявки
01instant_successaccepted → awaiting_payment → fulfilled, почти сразу
02slow_successТо же, но с заметной паузой перед fulfilled
10declined_no_executoraccepted → declined, decline_reason: no_executor_available
11declined_by_executoraccepted → awaiting_payment → declined, decline_reason: executor_rejected
20lapsedaccepted → lapsed
40dispute_upheld_fulfilledfulfilled → disputed → fulfilled
41dispute_reversedfulfilled → disputed → reversed
42dispute_upheld_declineddeclined → disputed → declined
43dispute_overturned_to_fulfilledlapsed → 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 у каждой заявки