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

Через 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="../book-of-reference/payment-system-codes">Код платежной системы</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" %}
Если после создания выплаты вам требуется проверить ее статус, то необходимо использовать запрос ["Информация по выплате"](https://help.unitpay.ru/payouts/payout_info)
{% 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 %}