PayOut - P2P - H2H

На этой странице описаны методы для работы с ордерами на вывод типа P2P по флоу H2H.

Создание ордера

Запрос

URL: POST https://<host>/api/v3/merchant/orders/payout/p2p/h2h

Заголовки:

• Content-Type: application/json
• Authorization: Bearer <YOUR-API-KEY>. См. страницу "Авторизация запросов"

Тело запроса:

Поле	Тип	Обязательное	Описание
methodID	integer	да	Метод ордера
amount	float64	да	Сумма ордера в фиате, округляется до 2 знаков
recipientNumber	string	нет*	Значение реквизита для перевода
recipientName	string	нет	Имя держателя реквизита для перевода
bankCode	string	нет	Код банка реквизита для перевода
clientID	string	нет	Идентификатор клиента
clientMetadata	object	нет	Данные клиента, см. "Общая информация"
merchantOrderID	string	нет	Идентификатор ордера мерчанта; уникален в рамках мерчанта
trafficType	string	нет	Тип трафика
callbackURL	string	нет	URL для отправки КБ

* - обязательность зависит от метода перевода; уточняйте при интеграции.

Пример cURL

curl -X 'POST' \
  'https://<host>/api/v3/merchant/orders/payout/p2p/h2h' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <YOUR-API-KEY>' \
  -d '{
  "methodID": 5,
  "amount": 100.12,
  "recipientNumber": "7777777777777777",
  "recipientName": "Ivan Ivanov",
  "bankCode": "SomeBank",
  "clientID": "ID1234",
  "merchantOrderID": "316b6280-d6e2-4627-bacd-fcda062438bc",
  "trafficType": "mixed",
  "callbackURL": "http://example.com/webhook"
}'

Ответ

HTTP Status Code: 200

Тело ответа - модель ордера OrderOut (см. "Общая информация"):

{
  "id": "46d9ff65-505d-4148-8172-6b8c0a09ded8",
  "createdAt": "2026-08-31T06:37:45.776331Z",
  "updatedAt": "2026-08-31T06:37:45.776331Z",
  "type": "PayOut",
  "direction": "PayOut",
  "status": "created",
  "merchantOrderID": "316b6280-d6e2-4627-bacd-fcda062438bc",
  "clientID": "ID1234",
  "methodID": 5,
  "currencyCode": "KRW",
  "amount": 100.12,
  "exchangeRate": 1600.1636,
  "trafficType": "mixed"
}

Возможные бизнес-отказы (400/409) - см. таблицу errorCode на странице "Авторизация запросов". Недостаточно USDT на балансе - 400 с errorCode = not_enough_money_on_balance; ордер не создаётся.

Замороженная часть баланса (frozenBalanceUSDT) связана с незавершёнными PayOut; см. страницу "Баланс".

Условия отправки коллбэков

Вебхук отправляется при переходе ордера в один из триггерных статусов. Полный список - на странице "Коллбэки".