Интеграция без головной боли
Подключите ваш сервис к Волтра за 15 минут. Мы подготовили чистый RESTful API, понятные примеры кода и вебхуки, которые работают так же надежно, как ваша любимая кофемашина.
Авторизация и токены
Безопасность — это забота о клиенте. Мы используем стандартный Bearer Token (JWT) для аутентификации.
Генерация ключей
Создавайте Production и Sandbox ключи в личном кабинете. Мы автоматически шифруем данные при передаче через HTTPS.
Валидация (TTL)
Токены живут 24 часа. Используйте Refresh Token для бесшовного обновления сессии без повторного ввода логина.
Ограничения (Rate Limit)
100 запросов в минуту для бесплатного тарифа. Не паникуйте: мы отправляем заголовок X-RateLimit-Remaining.
Эндпоинты платежей
Управляйте транзакциями, возвратами и статусами счетов через простые методы HTTP.
POST /v2/payments
Создание нового платежа. Принимает amount (в рублях), currency (RUB) и customer_id.
GET /v2/payments/:id
Получение статуса конкретной транзакции. Возвращает статусы: pending, succeeded, failed.
POST /v2/refunds
Полный или частичный возврат средств. Сумма возврата не может превышать сумму исходного платежа.
Вебхуки и события
Не опрашивайте API в цикле. Мы сами сообщим вам о важных событиях в вашем бизнесе.
payment.succeeded
Триггер срабатывает мгновенно после успешной оплаты клиентом. Идеально для отправки чека или разблокировки доступа.
payment.failed
Уведомление об ошибке оплаты. Содержит код ошибки (например, insufficient_funds) для информирования клиента.
invoice.overdue
Счет просрочен. Отличный повод для вашей CRM-системы отправить мягкое напоминание о долге.
Примеры кода
Никаких гаданий. Просто скопируйте и вставьте.
Python (Requests)
Создание платежа в пару строк:
import requests
url = "https://api.voltra.ru/v2/payments"
headers = {
"Authorization": "Bearer YOUR_API_KEY"
}
data = {
"amount": 1500,
"currency": "RUB",
"desc": "Кофе и круассан"
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
JavaScript (Node.js)
Асинхронная обработка события:
const axios = require('axios');
async function createPayment() {
try {
const res = await axios.post(
'https://api.voltra.ru/v2/payments',
{ amount: 1500, currency: 'RUB' },
{ headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
return res.data;
} catch (error) {
console.error('Ошибка:', error);
}
}
Нужна помощь с кодом?
Наша команда разработчиков поможет разобраться со сложными кейсами интеграции. Мы пишем код с душой.