# Создание выплаты

Через API возможно настроить только массовые выплаты.

```json
GET https://unitpay.ru/api

method               = massPayment
params[sum]          = 10.00
params[purse]        = 7951xxxxx71
params[login]        = partner@gmail.com
params[transactionId]= 1782
params[secretKey]    = ключ
params[paymentType]  = sbp

```

**Обязательные параметры:**

<table data-header-hidden><thead><tr><th width="153.77773030598956">name</th><th width="137.888916015625">type</th><th>description</th></tr></thead><tbody><tr><td><strong>login</strong></td><td>строка</td><td>Email партнера в системе UnitPay</td></tr><tr><td><strong>secretKey</strong></td><td>строка</td><td>Секретный ключ партнера, доступен в настройках профиля</td></tr><tr><td><strong>purse</strong></td><td>строка</td><td>Кошелек получателя, полный номер карты или номер телефона без "+" (для СБП выплат) </td></tr><tr><td><strong>transactionId</strong></td><td>текст</td><td>Уникальный ID выплаты на стороне партнера</td></tr><tr><td><strong>sum</strong></td><td>число</td><td>Сумма перевода в рублях, например: "100"</td></tr><tr><td><strong>paymentType</strong></td><td>строка</td><td><a href="/pages/-M9y0PdOWFK4DxzzyaSC">Код платежной системы</a><br>Поддерживаются: card, webmoney, sbp</td></tr><tr><td><strong>memberId</strong></td><td>строка</td><td>Идентификатор банка, который можно запросить по <a href="https://help.unitpay.ru/book-of-reference/poluchenie-spravochnika-bankov-uchastnikov-sbp-api">методу</a>. Требуется <strong>только</strong> для выплат СБП</td></tr></tbody></table>

**Дополнительные параметры:**

<table data-header-hidden><thead><tr><th width="151.55550130208331">name</th><th width="139.111083984375">type</th><th>description</th></tr></thead><tbody><tr><td><strong>projectId</strong></td><td>число</td><td>Уникальный ID проекта в системе UnitPay </td></tr><tr><td><strong>comment</strong></td><td>текст</td><td>Комментарий к выплате. Отображается только в вашем личном кабинете (разрешены только буквы, цифры, точки и запятые)</td></tr></tbody></table>

{% hint style="info" %}
**ВАЖНО:** всегда используйте уникальный **transactionId** для новых выплат, при получении существующего **transactionId** (вне зависимости от других параметров) возвращается текущий статус выплаты.&#x20;
{% endhint %}

{% hint style="success" %}
Если после создания выплаты вам требуется проверить ее статус, то необходимо использовать запрос ["Информация по выплате"](/payouts/payout_info.md)
{% endhint %}

#### Пример успешного ответа

```json
{
  "result": {
    "message":           "Выплата успешно проведена",
    "status":            "success",
    "payoutId":          "114233",
    "partnerBalance":    "15733.00",
    "createDate":        "2021-12-01 11:51:02",
    "completeDate":      "2021-12-01 11:52:02",
    "sum":               "300",
    "payoutCommission":  "6.00",
    "partnerCommission": "0.00"
  }
}
```

<table data-header-hidden><thead><tr><th width="190.8887939453125">name</th><th width="124.88887532552081">type</th><th>description</th></tr></thead><tbody><tr><td><strong>message</strong></td><td>строка</td><td>Комментарий успешной операции можно использовать как подсказку пользователю после выполнения запроса</td></tr><tr><td><strong>status</strong></td><td>строка</td><td>success — успешная выплата<br>not_completed — выплата отправлена в платежную систему, но еще не получено подтверждение (временный статус)</td></tr><tr><td><strong>payoutId</strong></td><td>число</td><td>Уникальный ID выплаты в системе UnitPay</td></tr><tr><td><strong>partnerBalance</strong></td><td>число</td><td>Баланс партнера в системе доступный для выплат</td></tr><tr><td><strong>createDate</strong></td><td>текст</td><td>Дата создания выплаты</td></tr><tr><td><strong>completeDate</strong></td><td>текст</td><td>Дата завершения выплаты</td></tr><tr><td><strong>sum</strong></td><td>число</td><td>Сумма выплаты</td></tr><tr><td><strong>payoutCommission</strong></td><td>число</td><td>Комиссия выплаты</td></tr><tr><td><strong>partnerCommission</strong></td><td>число</td><td>Комиссия партнера</td></tr></tbody></table>

#### Пример ошибочного ответа:

```json
{
    "error": {
        "message": "Выплата в указанной валюте на указанные реквизиты невозможна",
        "code": 122
    }
}
```

<table data-header-hidden><thead><tr><th width="145.99995930989581">name</th><th width="107.66668701171875">type</th><th>description</th></tr></thead><tbody><tr><td><strong>message</strong></td><td>string</td><td>Информация с описанием ошибки запроса</td></tr><tr><td><strong>code</strong></td><td>string</td><td>Код ошибки, подробная расшифровка в таблице ниже</td></tr></tbody></table>

#### **Описание возможных ошибок:**

<table data-header-hidden><thead><tr><th width="171.77777099609375">name</th><th>description</th></tr></thead><tbody><tr><td><strong>100</strong></td><td>Услуга "masspayment" отключена</td></tr><tr><td><strong>101</strong></td><td>Услуга "masspayment" для вас недоступна</td></tr><tr><td><strong>122</strong></td><td>Выплата в указанной валюте на указанные реквизиты невозможна</td></tr><tr><td><strong>1051</strong></td><td>Мы не смогли получить информацию о кошельке получателя средств. Проверьте номер кошелька и попробуйте повторить операцию снова или через некоторое время</td></tr></tbody></table>

**Технические ошибки:**

<table data-header-hidden><thead><tr><th width="174">name</th><th>description</th></tr></thead><tbody><tr><td><strong>-32000</strong></td><td>Неверные параметры авторизации (логин, секретный ключ)</td></tr><tr><td><strong>-32602</strong></td><td>Неверные параметры запроса</td></tr><tr><td><strong>-32603</strong></td><td>Внутренняя техническая ошибка</td></tr></tbody></table>

{% hint style="warning" %}
**ВАЖНО:** Если вы получили ошибку с кодом -**32603** воспользуйтесь запросом [информации о выплате](https://help.unitpay.ru/payouts/payout_info), поскольку выплата может изменить свой статус после перезапроса/
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.unitpay.ru/payouts/create_payout.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.