Выплаты, баланс и вывод #
Выплата (disburse) — деньги вашему клиенту. Вывод (settlement) — деньги вам, с баланса платформы. Это разные ручки.
Заголовки — в «Авторизации». Статусы — в «Статусах».
POST /gw/v1/disburse #
Создать выплату. Реквизит получателя знаете вы, поэтому он в запросе и наружу не возвращается.
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
merchant_reference | string | да | Ваш номер выплаты. Он же ключ идемпотентности |
amount | int64 | да* | Сумма целыми рублями, > 0 |
amount_minor | int64 | да* | Та же сумма в копейках |
currency | string | да | Валюта выплаты |
method | string | да | C2C или SBP, регистр не важен. Другое значение — 400 |
recipient | object | да | Реквизит получателя, см. ниже |
metadata | object | нет | Произвольный JSON. В ответах не возвращается |
recipient #
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
card_number | string | при C2C | Номер карты получателя. При SBP передавать нельзя — 400 |
sbp_phone | string | при SBP | Телефон получателя. При C2C передавать нельзя — 400 |
holder_name | string | нет | Имя получателя |
bank_code | string | нет | Код банка получателя |
Запрос
{
"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
{
"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.
Формат выплаты #
| Поле | Тип | Когда есть | Описание |
|---|---|---|---|
reference | string | всегда | Наш номер выплаты (ord_..., тот же префикс, что у приёма) |
merchant_reference | string | если передавали | Ваш номер выплаты |
status | string | всегда | Публичный статус. Фаза ожидания называется sending, не awaiting_payment |
amount_minor | int64 | всегда | Сумма в минимальных единицах |
currency | string | всегда | Валюта выплаты |
method | string | всегда | Способ выплаты |
recipient_last4 | string | если разобран реквизит | Последние 4 цифры карты или телефона получателя |
decline_reason | string | у части declined | Свободный текст причины, не код |
created_at | datetime | всегда | Создание |
updated_at | datetime | всегда | Последнее изменение |
settled_at | datetime | только исполненная | Момент исполнения |
Поля requisite у выплаты нет. Подтверждение перевода (чек) в ответ сегодня не попадает — запрашивайте через поддержку по reference.
Уведомления по выплатам платформа пока не шлёт — следите опросом, см. «Уведомления».
GET /gw/v1/account #
Баланс. Read-only, без побочных эффектов.
200
{
"balances": [
{
"currency": "USDT",
"balance_minor": 15150000,
"in_flight_minor": 500000,
"available_minor": 14650000
}
]
}| Поле | Тип | Описание |
|---|---|---|
currency | string | Валюта счёта |
balance_minor | int64 | Всего начислено. Суммы под незавершёнными выплатами сюда не входят — они заморожены |
in_flight_minor | int64 | Заморожено в незавершённых выводах |
available_minor | int64 | Доступно к выводу прямо сейчас. Для проверки «хватает ли денег» — это поле |
Баланс ведётся в USDT, даже если заявки были в RUB: исполненная заявка конвертируется по курсу, зафиксированному при её создании. Текущий курс — GET /gw/v1/rates/{currency}.
Ошибки: 401 UNAUTHORIZED, 429 RATE_LIMITED.
GET /gw/v1/rates/{currency} #
Курс, по которому ваша заявка в валюте {currency} пересчиталась бы в USDT, будь она создана прямо сейчас. Это ваш курс, с вашими условиями: у разных мерчантов он может отличаться.
{currency} — валюта заявки, например RUB. Регистр не важен.
200
{
"currency": "RUB",
"settlement_currency": "USDT",
"rate": "87.22360796",
"rate_e8": 8722360796,
"observed_at": "2026-09-30T10:53:22Z"
}| Поле | Тип | Описание |
|---|---|---|
currency | string | Валюта заявки |
settlement_currency | string | Валюта баланса, всегда USDT |
rate | string | Сколько единиц currency за 1 USDT. Строкой, чтобы не терять знаки: разбирайте десятичным типом, не float |
rate_e8 | int64 | Тот же курс целым числом: rate × 10^8 |
observed_at | string | Когда курс снят с биржи, 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 #
История проводок по балансу, от новых к старым.
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
limit | int | нет | По умолчанию 50, максимум 200 (больше — молча урезается) |
offset | int | нет | По умолчанию 0. Отрицательный — 400 |
200
{
"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_at | datetime | Когда проводка случилась |
type | string | credit (баланс вырос) или debit (упал) |
amount_minor | int64 | Сумма проводки |
currency | string | Валюта проводки |
kind | string | deposit, withdrawal, refund или other |
reference | string | Номер связанной заявки (ord_...) или вывода (wd_...). Может отсутствовать |
limit, offset | int | Применённые значения после урезания |
Ошибки: 400 INVALID_ARGUMENT (limit/offset не целое, отрицательный offset), 401 UNAUTHORIZED, 429 RATE_LIMITED.
POST /gw/v1/settlement #
Заказать вывод средств с баланса на ваш адрес. Валюта всегда USDT и в запросе не передаётся.
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
merchant_reference | string | да | Ваш номер вывода. Он же ключ идемпотентности |
amount_minor | int64 | да | Сумма в минимальных единицах USDT, > 0 и не больше available_minor |
chain_id | string | да | Сеть USDT (TRC20, ERC20, ...). Должна совпадать с сетью вашего payout_address_id |
payout_address_id | string (UUID) | да | Заранее зарегистрированный адрес вывода |
Запрос
{
"merchant_reference": "settlement-12",
"amount_minor": 5000000,
"chain_id": "TRC20",
"payout_address_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"
}201 — создан, 200 — повтор с тем же merchant_reference.
{
"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.