Фінанси

Історія балансу, покупки й посилання на поповнення.

Адреса: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`	Панель або нода не відповіли — повторіть пізніше