Финансы

История баланса, покупки и ссылки на пополнение.

Адрес:https://sourhost.net/api/v1·Авторизация: Authorization: Bearer sh_live_…

GET/account/transactions— История баланса GET/account/purchases— Покупки POST/account/topup/liqpay— Ссылка на пополнение GET/account/topup/liqpay/:orderId— Статус пополнения

GET/account/transactions

История баланса

Пополнения и списания.

Право: billing:read

Пример запроса

curl "https://sourhost.net/api/v1/account/transactions" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Ответ

204 Пустой ответ

GET/account/purchases

Покупки

Право: billing:read

Пример запроса

curl "https://sourhost.net/api/v1/account/purchases" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Ответ

204 Пустой ответ

POST/account/topup/liqpay

Ссылка на пополнение

Создаёт платёж LiqPay. Оплачивает его сам пользователь на странице LiqPay — запрос ничего не списывает.

Право: billing:topup

Параметры

amountUahобязательный body · number Сумма в гривнях

Пример запроса

curl -X POST "https://sourhost.net/api/v1/account/topup/liqpay" \
  -H "Authorization: Bearer $SOURHOST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amountUah":500}'

Ответ

HTTP

HTTP/2 200 OK
{
  "checkoutUrl": "https://www.liqpay.ua/api/3/checkout",
  "data": "eyJ…",
  "signature": "Zm…",
  "orderId": "topup_8b1f2c",
  "sandbox": false
}

GET/account/topup/liqpay/:orderId

Статус пополнения

Право: billing:read

Параметры

orderIdобязательный path · string ID платежа из ответа на пополнение

Пример запроса

curl "https://sourhost.net/api/v1/account/topup/liqpay/topup_8b1f2c" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Ответ

204 Пустой ответ

Общие ошибки

Любой метод может ответить так. Подробнее об ошибках

400	`bad_request`	Неверное тело или параметры
401	`token_invalid`	Токен неверный, отозван или просрочен
403	`token_scope_missing`	У токена нет нужного права
403	`token_project_forbidden`	Проект или услуга вне ограничений токена
404	`not_found`	Нет такого проекта, услуги или объекта
429	`token_rate_limited`	Слишком много запросов, см. Retry-After
503	`upstream_unavailable`	Панель или нода не ответили — повторите позже