PayOut - P2P - H2H#

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

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

Запрос#

URL: POST https://<host>/api/v1/payout

Заголовки:

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

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

Поле	Тип	Обязательное	Описание
`methodID`	integer	да	Метод перевода. Будет сообщен при интеграции
`amount`	float64	да	Сумма платежа в валюте, заданной методом
`trafficType`	string	нет	Тип трафика. Возможные значения: `"ftd"` (первичный), `"td"` (вторичный, доверенный), `"mixed"` (смешанный). Если значение не указано, используется `"mixed"`
`number`	string	нет**	Номер (карты/аккаунта/телефона/...) для перевода
`link`	string	нет**	Ссылка для перевода
`nameMediator`	string	да	Имя владельца карты/аккаунта/...
`bankCode`	string	нет*	Код банка для перевода. Доступные значения будут сообщены при интеграции
`clientID`	string	нет*	ID или имя клиента мерчанта
`idTransactionMerchant`	string	нет	ID ордера в системе мерчанта. Должен быть уникальным в рамках одного аккаунта мерчанта
`integrationMerhcnatData.webHook`	string	нет	URL-адрес, по которому будут направлены callback-запросы при изменениях в одрере. ⚠️ Название поля содержит опечатку — необходимо передавать именно `integrationMerhcnatData`

* - может являться обязательмым для отдельных интеграций
** - зависит от methodID

Пример cURL#

curl -X POST "https://<host>/api/v1/payout" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <YOUR-API-KEY>" \
-d '{
"methodID": 5,
  "amount": 10,
  "number": "7777 7777 7777 7777",
  "nameMediator": "Ivan Ivanov",
  "bankCode": "SomeBank",
  "integrationMerhcnatData": {
    "webHook": "https://example.com"
  }
}'

Ответ#

См. раздел "Структура ответа API методов"

Успешное создание ордера#

HTTP Status Code: 200

Тело ответа:

{
  "data": {
    "id": "46d9ff65-505d-4148-8172-6b8c0a09ded8",
    "dateAdded": "2025-11-29T06:37:45.776331Z",
    "dateUpdated": "2025-11-29T06:37:45.776331Z",
    "orderType": "payOut",
    "status": "created",
    "amount": 10,
    "amountComission": 1,
    "currency": "KRW",
    "idTransactionMerchant": null,
    "merchantID": "61691859-9eb1-4a6f-ae55-f93589dff66d",
  },
  "result": {
    "codeError": "none",
    "message": null,
    "status": "success",
    "x-request-id": "b05c89fb95488753375a2dbfe865bb18"
  }
}

Описание полей структуры data:

Поле	Тип	Обязательное	Описание
`id`	string	да	Уникальный ID ордера в системе MoneyMania
`dateAdded`	string	да	Дата и время создания ордера
`dateUpdated`	string	да	Дата и время последнего обновления ордера
`orderType`	string	да	Тип ордера
`status`	string	да	Статус ордера. См. статусную модель
`idTransactionMerchant`	string	нет	ID ордера в системе мерчанта
`amount`	float64	да	Сумма ордера в валюте ордера
`amountComission`	float64	да	Сумма комиссии мерчанта в валюте ордера
`currency`	string	да	Валюта ордера
`merchantID`	string	да	ID мерчанта, от которого поступил ордер

Условия отправки callback-запросов #

Переход ордера в статусы (См. статусную модель):

succeeded
all_terminals_failed
failed_by_appeal
succeeded_by_appeal