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

Через API возможно настроить только массовые выплаты. Для взаимодействия с API используйте библиотеку Unitpay PHP-SDK

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]=qiwi

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

Значение

Описание

login

строка

Email партнера в системе UnitPay

secretKey

строка

Секретный ключ партнера, доступен в настройках профиля

purse

строка

Кошелек получателя, полный номер карты или номер телефона без "+" (для СБП выплат)

transactionId

текст

Уникальный ID выплаты на стороне партнера

sum

число

Сумма перевода в рублях, например: "10.50"

paymentType

строка

Код платежной системы: Поддерживаются: card, qiwi, 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": 

Значение

Описание

message

строка

Информация с описанием ошибки запроса

code

строка

Код ошибки, подробная расшифровка в таблице ниже

Ошибки:

Описание

100

Услуга "масспеймент" отключена

101

Услуга "масспеймент" для вас недоступна

102

Минимальная сумма единовременного платежа должна быть более 1 рубля

103

Сумма выплаты должна быть меньше или равна текущему балансу

104

Номер телефона не входит в список доступных для выплат стран

1051

Мы не смогли получить информацию о кошельке получателя средств. Проверьте номер кошелька и попробуйте повторить операцию снова или через некоторое время

1052

Мы не смогли получить информацию о номере карты. Проверьте номер карты и попробуйте повторить операцию снова или через некоторое время

1053

Мы не смогли получить информацию о номере телефона. Проверьте номер телефона и попробуйте повторить операцию снова или через некоторое время

201

Мы не смогли перевести средства на указанный вами счет Это может быть связано с ограничениями счета получателя средств или ошибками на платформе платежной системы.

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

Описание

-32000

Ошибка авторизации

-32602

Ошибочные параметры запроса

-32603

Внутренняя техническая ошибка

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

Last updated