GGWPAY docs

Выплаты, баланс и вывод #

Выплата (disburse) — деньги вашему клиенту. Вывод (settlement) — деньги вам, с баланса платформы. Это разные ручки.

Заголовки — в «Авторизации». Статусы — в «Статусах».

POST /gw/v1/disburse #

Создать выплату. Реквизит получателя знаете вы, поэтому он в запросе и наружу не возвращается.

ПолеТипОбяз.Описание
merchant_referencestringдаВаш номер выплаты. Он же ключ идемпотентности
amountint64да*Сумма целыми рублями, > 0
amount_minorint64да*Та же сумма в копейках
currencystringдаВалюта выплаты
methodstringдаC2C или SBP, регистр не важен. Другое значение — 400
recipientobjectдаРеквизит получателя, см. ниже
metadataobjectнетПроизвольный JSON. В ответах не возвращается

recipient #

ПолеТипОбяз.Описание
card_numberstringпри C2CНомер карты получателя. При SBP передавать нельзя — 400
sbp_phonestringпри SBPТелефон получателя. При C2C передавать нельзя — 400
holder_namestringнетИмя получателя
bank_codestringнетКод банка получателя

Запрос

json
{
  "merchant_reference": "payout-77",
  "amount": 5000,
  "currency": "RUB",
  "method": "C2C",
  "recipient": {
    "card_number": "4111111111111111",
    "holder_name": "PETR PETROV",
    "bank_code": "SBERBANK"
  }
}

201 — создана, 200 — повтор с тем же merchant_reference. Тело — в формате выплаты, статус accepted.

Деньги замораживаются сразу. При создании сумма выплаты вместе с комиссией (в USDT по курсу на эту минуту) снимается с вашего баланса и держится под выплату. Выплата исполнена — замороженное списано; отменена или не исполнена — вернулось на баланс. Не хватает доступного баланса — выплата не создаётся, ответ 402. Проверить заранее — available_minor в GET /gw/v1/account.

Отменить выплату можно, только пока её не взял исполнитель: после этого он мог уже перевести деньги, и отмена отвечает 409.

Ошибки: 400 INVALID_ARGUMENT (пустое тело, нет обязательного поля, amount_minor <= 0, неизвестный method, реквизит не соответствует способу, неизвестное поле, способ или сумма вне настроек выплат магазина), 401 UNAUTHORIZED, 403 FORBIDDEN (ключ без p2p:payout; выплаты по магазину ключа выключены), 402 PAYMENT_DECLINED (не хватает доступного баланса на сумму с комиссией; исчерпан лимит выплат магазина на сутки по Москве), 409 IDEMPOTENCY_CONFLICT (тот же merchant_reference с другой суммой, валютой, способом или получателем), 429 RATE_LIMITED, 503 UNAVAILABLE (курс временно недоступен — выплату нельзя посчитать, повторите позже).

GET /gw/v1/disburse/{reference} #

Состояние выплаты.

200

json
{
  "reference": "ord_01J8ZB2C3D4E5F6G7H8J9K0L1M",
  "merchant_reference": "payout-77",
  "status": "sending",
  "amount_minor": 500000,
  "currency": "RUB",
  "method": "C2C",
  "recipient_last4": "1111",
  "created_at": "2026-09-22T12:00:00Z",
  "updated_at": "2026-09-22T12:05:00Z"
}

Ошибки: 401 UNAUTHORIZED, 404 NOT_FOUND (нет такой выплаты, она чужая или по этому номеру лежит заявка на приём — её запрашивайте через /gw/v1/collect/{reference}), 429 RATE_LIMITED.

Формат выплаты #

ПолеТипКогда естьОписание
referencestringвсегдаНаш номер выплаты (ord_..., тот же префикс, что у приёма)
merchant_referencestringесли передавалиВаш номер выплаты
statusstringвсегдаПубличный статус. Фаза ожидания называется sending, не awaiting_payment
amount_minorint64всегдаСумма в минимальных единицах
currencystringвсегдаВалюта выплаты
methodstringвсегдаСпособ выплаты
recipient_last4stringесли разобран реквизитПоследние 4 цифры карты или телефона получателя
decline_reasonstringу части declinedСвободный текст причины, не код
created_atdatetimeвсегдаСоздание
updated_atdatetimeвсегдаПоследнее изменение
settled_atdatetimeтолько исполненнаяМомент исполнения

Поля requisite у выплаты нет. Подтверждение перевода (чек) в ответ сегодня не попадает — запрашивайте через поддержку по reference.

Уведомления по выплатам платформа пока не шлёт — следите опросом, см. «Уведомления».


GET /gw/v1/account #

Баланс. Read-only, без побочных эффектов.

200

json
{
  "balances": [
    {
      "currency": "USDT",
      "balance_minor": 15150000,
      "in_flight_minor": 500000,
      "available_minor": 14650000
    }
  ]
}
ПолеТипОписание
currencystringВалюта счёта
balance_minorint64Всего начислено. Суммы под незавершёнными выплатами сюда не входят — они заморожены
in_flight_minorint64Заморожено в незавершённых выводах
available_minorint64Доступно к выводу прямо сейчас. Для проверки «хватает ли денег» — это поле

Баланс ведётся в USDT, даже если заявки были в RUB: исполненная заявка конвертируется по курсу, зафиксированному при её создании. Текущий курс — GET /gw/v1/rates/{currency}.

Ошибки: 401 UNAUTHORIZED, 429 RATE_LIMITED.

GET /gw/v1/rates/{currency} #

Курс, по которому ваша заявка в валюте {currency} пересчиталась бы в USDT, будь она создана прямо сейчас. Это ваш курс, с вашими условиями: у разных мерчантов он может отличаться.

{currency} — валюта заявки, например RUB. Регистр не важен.

200

json
{
  "currency": "RUB",
  "settlement_currency": "USDT",
  "rate": "87.22360796",
  "rate_e8": 8722360796,
  "observed_at": "2026-09-30T10:53:22Z"
}
ПолеТипОписание
currencystringВалюта заявки
settlement_currencystringВалюта баланса, всегда USDT
ratestringСколько единиц currency за 1 USDT. Строкой, чтобы не терять знаки: разбирайте десятичным типом, не float
rate_e8int64Тот же курс целым числом: rate × 10^8
observed_atstringКогда курс снят с биржи, RFC3339 UTC

Заявка в USDT до комиссии: amount_minor / 100 / rate, с округлением вниз.

Курс обновляется раз в минуту, и на заявку ложится тот, что действует в момент её создания. Поэтому курс, полученный этой ручкой заранее, — ориентир, а не обещание. Курс, который лёг на конкретную заявку, приходит в ней самой — поле rate в ответе на создание и в GET /gw/v1/collect/{reference}.

Ошибки: 400 INVALID_ARGUMENT (не код валюты), 401 UNAUTHORIZED, 404 NOT_FOUND (по этой валюте курса нет), 429 RATE_LIMITED, 503 UNAVAILABLE (курс временно недоступен).

GET /gw/v1/account/movements #

История проводок по балансу, от новых к старым.

ПараметрТипОбяз.Описание
limitintнетПо умолчанию 50, максимум 200 (больше — молча урезается)
offsetintнетПо умолчанию 0. Отрицательный — 400

200

json
{
  "movements": [
    {
      "occurred_at": "2026-09-22T12:03:00Z",
      "type": "credit",
      "amount_minor": 985000,
      "currency": "USDT",
      "kind": "deposit",
      "reference": "ord_01J8Z9QF3K4M5N6P7Q8R9S0T1U"
    }
  ],
  "limit": 50,
  "offset": 0
}
ПолеТипОписание
occurred_atdatetimeКогда проводка случилась
typestringcredit (баланс вырос) или debit (упал)
amount_minorint64Сумма проводки
currencystringВалюта проводки
kindstringdeposit, withdrawal, refund или other
referencestringНомер связанной заявки (ord_...) или вывода (wd_...). Может отсутствовать
limit, offsetintПрименённые значения после урезания

Ошибки: 400 INVALID_ARGUMENT (limit/offset не целое, отрицательный offset), 401 UNAUTHORIZED, 429 RATE_LIMITED.

POST /gw/v1/settlement #

Заказать вывод средств с баланса на ваш адрес. Валюта всегда USDT и в запросе не передаётся.

ПолеТипОбяз.Описание
merchant_referencestringдаВаш номер вывода. Он же ключ идемпотентности
amount_minorint64даСумма в минимальных единицах USDT, > 0 и не больше available_minor
chain_idstringдаСеть USDT (TRC20, ERC20, ...). Должна совпадать с сетью вашего payout_address_id
payout_address_idstring (UUID)даЗаранее зарегистрированный адрес вывода

Запрос

json
{
  "merchant_reference": "settlement-12",
  "amount_minor": 5000000,
  "chain_id": "TRC20",
  "payout_address_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"
}

201 — создан, 200 — повтор с тем же merchant_reference.

json
{
  "reference": "wd_01J8ZC4D5E6F7G8H9J0K1L2M3N",
  "merchant_reference": "settlement-12",
  "status": "accepted",
  "amount_minor": 5000000,
  "currency": "USDT",
  "created_at": "2026-09-22T12:00:00Z",
  "updated_at": "2026-09-22T12:00:00Z"
}

Статусы вывода — только accepted, fulfilled, declined: плательщика тут нет, ждать нечего, кроме исполнения. decline_reason бывает пустым и у отклонённого вывода.

Ошибки: 400 INVALID_ARGUMENT (нет merchant_reference, payout_address_id не UUID, amount_minor <= 0, пустой chain_id, недостаточно доступных средств, сеть адреса не совпала с chain_id, адрес принадлежит не вам), 401 UNAUTHORIZED, 404 NOT_FOUND (адрес вывода не найден, либо USDT в этой сети не поддерживается), 409 CONFLICT (адрес вывода не в статусе ACTIVE), 409 IDEMPOTENCY_CONFLICT (тот же merchant_reference с другой суммой, валютой, сетью или адресом), 429 RATE_LIMITED.

GET /gw/v1/settlement/{reference} #

Состояние вывода. Формат ответа — тот же, что у создания.

Ошибки: 401 UNAUTHORIZED, 404 NOT_FOUND, 429 RATE_LIMITED.