GGWPAY docs

Документация 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 в теле нет

Заголовки авторизации и подписи — одной таблицей в «Авторизации».

Три вещи, на которых ломается интеграция #

  1. fulfilled / declined / lapsed не окончательны: спор открывается ещё семь дней, статус может измениться — «Статусы».
  2. Выданный реквизит не меняется: заявка из awaiting_payment уходит только в fulfilled или lapsed — «Приём средств».
  3. Уведомления приходят хотя бы один раз и не по порядку — дедуп по X-GGWPay-Event-Id, применяйте по occurred_at — «Уведомления».

Разделы #