Создание выплаты
Через API возможно настроить только массовые выплаты. Для взаимодействия с API используйте библиотеку Unitpay PHP-SDK
https://unitpay.ru/api?
method=massPayment
params[sum]=10.00
params[purse]=7951xxxxx71
params[login][email protected]
params[transactionId]=1782
params[secretKey]=ключ
params[paymentType]=qiwi
Обязательные параметры:
Значение
Описание
login
строка
Email партнера в системе UnitPay
secretKey
строка
Секретный ключ партнера, доступен в настройках профиля
purse
строка
Кошелек получателя, полный номер карты или номер телефона без "+" (для СБП выплат)
transactionId
текст
Уникальный ID выплаты на стороне партнера
sum
число
Сумма перевода в рублях, например: "10.50"
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
Was this helpful?