Текущий баланс (API)

Узнать сумму баланса на вашем аккаунте, доступного к выплате, можно по API. В ответе сервера выводится как информация об общем балансе, доступном для выплаты, так и информация о конкретных счетах по неттинг-схеме. Для взаимодействия с API рекомендуется использовать библиотеку Unitpay PHP-SDK

https://unitpay.ru/api?method=getPartner 
params[login]=partner@gmail.com 
params[secretKey]=ключ

Значение

Описание

login

строка

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

secretKey

строка

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

Успешный ответ

{
    "result": {
        "email": "test@gmail.com",
        "balance": "3127.59",
        "balance_payout": "1227.59",
        "accounts": {
            "netting_qiwibank": {
                "balance": "2899.70",
                "balance_available": "999.70"
            },
            "netting_webmoney": {
                "balance": "0.01",
                "balance_available": "0.01"
            },
        }
    }
}

Значение

Описание

email

email

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

balance

число

Баланс партнера в рублях

balance_payout

число

Баланс партнера, доступный для вывода, в рублях (вводится с 15.06.21)

Ошибочный ответ

{"error": {
    "message": "Неверный секретный ключ",
    "code": -32000
}}

Описание

-32000

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

-32602

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

-32603

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

Важно! Некоторые суммы на аккаунте могут быть захолдированы отдельно по разным счетам.

Часть баланса может быть недоступна для выплаты на некоторое время, в зависимости от холда.

Типы холдов:

  1. Статический холд - на вашем балансе холдируется определенная сумма, которую вы не можете вывести пока холд не будет снят.

  2. Динамический холд - холд на дни. Все принятые средства от ваших клиентов блокируются на определенное количество дней, по истечению которых вы сможете вывести средства. Например, если динамический холд установлен на 3 дня, то средства, полученные в этот понедельник, будут доступны к выводу в четверг. Полученные в этот вторник - в пятницу и т.д.

  3. Холд по платежам - аналогично "Статистическому холду", но в рамках конкретных платежей.

Если на вашем аккаунте установлен холд определенного типа, вы получите уведомление в ЛК.

Last updated