Платежи
Пополнение баланса и управление платежами.
Способы оплаты
YooKassa (Россия)
Поддерживаемые способы:
| Способ | Комиссия | Мин. сумма |
|---|---|---|
| Банковская карта | 0% | 100 ₽ |
| ЮMoney | 0% | 100 ₽ |
| SberPay | 0% | 100 ₽ |
| Tinkoff Pay | 0% | 100 ₽ |
| СБП (QR-код) | 0% | 100 ₽ |
Создание платежа
Через личный кабинет
- Войдите в личный кабинет
- Перейдите в раздел "Биллинг"
- Введите сумму пополнения (в рублях)
- Выберите способ оплаты
- Завершите платёж
Через API
curl https://api.aipomogator.ru/api/v1/payment/create \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 1000,
"currency": "RUB"
}'
Ответ:
{
"paymentId": "pay_abc123",
"confirmationUrl": "https://yookassa.ru/checkout/...",
"amount": 1000,
"currency": "RUB",
"status": "pending"
}
Конвертация валют
Баланс хранится в USD. Конвертация по текущему курсу при пополнении.
Пополнение: 1000 ₽
Курс на момент оплаты: 95 ₽/$
Зачислено на баланс: $10.53
Получение текущего курса
curl https://api.aipomogator.ru/api/v1/billing/rates \
-H "Authorization: Bearer $API_KEY"
{
"USD_RUB": 95.50,
"updated_at": "2025-01-24T12:00:00Z"
}
Проверка баланса
curl https://api.aipomogator.ru/api/v1/user/balance \
-H "Authorization: Bearer $API_KEY"
{
"balance": 15.50,
"currency": "USD"
}
История платежей
curl https://api.aipomogator.ru/api/v1/payment/history \
-H "Authorization: Bearer $API_KEY"
{
"payments": [
{
"id": "pay_abc123",
"amount": 1000,
"currency": "RUB",
"usd_amount": 10.53,
"status": "succeeded",
"created_at": "2025-01-24T10:30:00Z"
}
]
}
Статусы платежа
| Статус | Описание |
|---|---|
pending | Ожидает оплаты |
waiting_for_capture | Оплачен, ожидает подтверждения |
succeeded | Успешно завершён |
canceled | Отменён |
Фискальный чек (54-ФЗ)
Все платежи проводятся с выдачей электронного чека согласно 54-ФЗ.
Чек отправляется на email, указанный при регистрации.
Данные чека:
- Наименование: "Услуги доступа к API"
- НДС: Не облагается (УСН)
- Признак: Аванс
Возвраты
Условия возврата
- Запрос в течение 14 дней с момента оплаты
- Неиспользованная часть баланса
Процедура
- Напишите на support@aipomogator.ru
- Укажите ID платежа и причину
- Возврат в течение 5-10 рабочих дней
Лимиты
| Параметр | Значение |
|---|---|
| Мин. пополнение | 100 ₽ |
| Макс. пополнение | 100,000 ₽ |
| Пополнений в день | До 10 |