Пополнение баланса
Создает транзакцию пополнения счета и возвращает ссылку на платежный шлюз (Robokassa). После успешной оплаты средства будут зачислены на баланс автоматически через вебхук.
POST https://api.yougpu.ru/billing/deposit
Заголовки (Headers)
| Заголовок | Значение | Описание |
|---|---|---|
| X-API-KEY | <YOUR_API_KEY> | Ваш API ключ |
| Content-Type | application/json | Формат данных |
Параметры тела (Body)
Заголовок раздела «Параметры тела (Body)»Параметр
Тип
Описание
amount*numberСумма пополнения (в рублях).
amount*
Примеры кода
Заголовок раздела «Примеры кода»curl -X POST "https://api.yougpu.ru/billing/deposit" \ -H "X-API-KEY: <YOUR_API_KEY>" \ -H "Content-Type: application/json" \ -d '{ "amount": 1500 }'import requests
url = "https://api.yougpu.ru/billing/deposit"headers = { "X-API-KEY": "<YOUR_API_KEY>", "Content-Type": "application/json"}data = { "amount": 1500}
response = requests.post(url, json=data, headers=headers)print(response.json())const response = await fetch('https://api.yougpu.ru/billing/deposit', { "method": "POST", "headers": { "X-API-KEY": "<YOUR_API_KEY>", "Content-Type": "application/json" }, "body": JSON.stringify({ "amount": 1500 })});const data = await response.json();console.log(data); 201 Created
{ "status": "success", "code": 201, "data": { "link": "https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=...", "payment_id": "550e8400-e29b-41d4-a716-446655440000" }}Структура ответа
Заголовок раздела «Структура ответа»Параметр
Тип
Описание
statusstringСтатус выполнения запроса (например, success).
status
codenumberHTTP код ответа.
code
dataobjectДанные ответа:
data
linkstringURL-адрес платежной страницы, на которую нужно перенаправить пользователя.
link
payment_idstringВнутренний идентификатор транзакции (UUID), который можно использовать для проверки статуса.
payment_id