Документация GGWPAY #
Справочник по API мерчанта: приём платежей и выплаты.
Платёжной страницы у нас нет — реквизит для оплаты вы получаете в JSON и показываете плательщику сами.
База: https://api.ggwpayments.com. Только HTTPS.
Ручки #
| Метод | Путь | Назначение |
|---|---|---|
POST | /gw/v1/collect | Создать заявку на приём |
GET | /gw/v1/collect/{reference} | Состояние заявки на приём |
POST | /gw/v1/collect/{reference}/cancel | Отменить неоплаченную заявку |
POST | /gw/v1/collect/{reference}/claim | Открыть спор |
DELETE | /gw/v1/collect/{reference}/claim | Отозвать спор |
GET | /gw/v1/catalog/banks | Справочник банков: расшифровка bank_code |
POST | /gw/v1/disburse | Создать выплату |
GET | /gw/v1/disburse/{reference} | Состояние выплаты |
GET | /gw/v1/account | Баланс |
GET | /gw/v1/rates/{currency} | Ваш курс пересчёта в USDT |
GET | /gw/v1/account/movements | История движений по балансу |
POST | /gw/v1/settlement | Заказать вывод средств |
GET | /gw/v1/settlement/{reference} | Состояние вывода |
POST | /sandbox/v1/collect | Тестовая заявка на приём |
GET | /sandbox/v1/collect/{reference} | Состояние тестовой заявки |
Других ручек в контракте нет.
Соглашения #
| Правило | Пояснение |
|---|---|
| Суммы | Целые числа в минимальных единицах: amount_minor: 1000000 при RUB = 10 000,00 ₽ |
| Время | RFC3339 UTC (2026-09-23T10:15:00Z) |
| Тело | JSON. Неизвестные поля отвергаются с 400, а не игнорируются |
| Размер тела | До 1 МиБ, иначе 413 REQUEST_TOO_LARGE |
| Идемпотентность | merchant_reference — ваш номер заказа и ключ идемпотентности |
| Номера | reference заявки — ord_..., вывода — wd_..., тестовой заявки — sbxcol_... |
| Направление | Задаётся путём (/collect — приём, /disburse — выплата), поля direction в теле нет |
Заголовки авторизации и подписи — одной таблицей в «Авторизации».
Три вещи, на которых ломается интеграция #
fulfilled/declined/lapsedне окончательны: спор открывается ещё семь дней, статус может измениться — «Статусы».- Выданный реквизит не меняется: заявка из
awaiting_paymentуходит только вfulfilledилиlapsed— «Приём средств». - Уведомления приходят хотя бы один раз и не по порядку — дедуп по
X-GGWPay-Event-Id, применяйте поoccurred_at— «Уведомления».