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

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

GET https://unitpay.ru/api

method               = massPayment
params[sum]          = 10.00
params[purse]        = 7951xxxxx71
params[login]        = [email protected]
params[transactionId]= 1782
params[secretKey]    = ключ
params[paymentType]  = sbp

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

login	строка	Email партнера в системе UnitPay
secretKey	строка	Секретный ключ партнера, доступен в настройках профиля
purse	строка	Кошелек получателя, полный номер карты или номер телефона без "+" (для СБП выплат)
transactionId	текст	Уникальный ID выплаты на стороне партнера
sum	число	Сумма перевода в рублях, например: "100"
paymentType	строка	Код платежной системы Поддерживаются: card, webmoney, usdt, sbp
memberId	строка	Идентификатор банка, который можно запросить по методу. Требуется только для выплат СБП

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

projectId	число	Уникальный ID проекта в системе UnitPay
comment	текст	Комментарий к выплате. Отображается только в вашем личном кабинете (разрешены только буквы, цифры, точки и запятые)

ВАЖНО: всегда используйте уникальный transactionId для новых выплат, при получении существующего transactionId (вне зависимости от других параметров) возвращается текущий статус выплаты.

Если после создания выплаты вам требуется проверить ее статус, то необходимо использовать запрос "Информация по выплате"

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

{
  "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"
  }
}

message	строка	Комментарий успешной операции можно использовать как подсказку пользователю после выполнения запроса
status	строка	success — успешная выплата not_completed — выплата отправлена в платежную систему, но еще не получено подтверждение (временный статус)
payoutId	число	Уникальный ID выплаты в системе UnitPay
partnerBalance	число	Баланс партнера в системе доступный для выплат
createDate	текст	Дата создания выплаты
completeDate	текст	Дата завершения выплаты
sum	число	Сумма выплаты
payoutCommission	число	Комиссия выплаты
partnerCommission	число	Комиссия партнера

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

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

message	string	Информация с описанием ошибки запроса
code	string	Код ошибки, подробная расшифровка в таблице ниже

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

100	Услуга "masspayment" отключена
101	Услуга "masspayment" для вас недоступна
122	Выплата в указанной валюте на указанные реквизиты невозможна
1051	Мы не смогли получить информацию о кошельке получателя средств. Проверьте номер кошелька и попробуйте повторить операцию снова или через некоторое время

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

-32000	Неверные параметры авторизации (логин, секретный ключ)
-32602	Неверные параметры запроса
-32603	Внутренняя техническая ошибка

ВАЖНО: Если вы получили ошибку с кодом -32603 воспользуйтесь запросом информации о выплате, поскольку выплата может изменить свой статус после перезапроса/