Документация OOPay
Полное руководство по интеграции платежей через СБП. API документация, примеры кода и best practices.
Получить API ключ
Зарегистрируйтесь и получите доступ к API
НачатьСоздать платеж
Узнайте как принимать платежи
ПодробнееWebhooks
Настройте уведомления о платежах
НастроитьВведение
OOPay API позволяет интегрировать платежи через Систему Быстрых Платежей (СБП) в ваше приложение или сайт. Наш RESTful API прост в использовании и поддерживает все современные стандарты безопасности.
Базовый URL API: https://api.oopay.me/v1
Регистрация и API ключи
Для начала работы с API вам необходимо зарегистрироваться и получить API ключи:
- Зарегистрируйтесь в личном кабинете
- Подайте заявку на регистрацию ТСП (торгово-сервисного предприятия)
- После одобрения заявки получите API ключи в разделе "Настройки → API"
Важно: Никогда не передавайте ваши API ключи третьим лицам и не публикуйте их в публичных репозиториях.
Аутентификация
Все запросы к API должны содержать заголовок Authorization с вашим API ключом:
Authorization: Bearer YOUR_API_KEYСоздание платежа
Для создания платежа отправьте POST запрос на /v1/payments:
// Создание платежа
const payment = await fetch('https://api.oopay.me/v1/payments', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 1000,
currency: 'RUB',
description: 'Оплата заказа #123',
qr_type: 'dynamic'
})
});
const data = await payment.json();
console.log(data.qr_data); // QR код для оплатыПараметры запроса:
amountnumber (обязательно)Сумма платежа в копейках
currencystringВалюта (по умолчанию: RUB)
descriptionstringОписание платежа
qr_typestringТип QR-кода: static, dynamic
Генерация QR-кодов
OOPay поддерживает два типа QR-кодов:
Статический QR-код
Используется для приёма платежей на фиксированную сумму. Идеален для торговых точек.
Динамический QR-код
Генерируется для каждого платежа индивидуально. Рекомендуется для онлайн-платежей.
// Генерация QR-кода
const qr = await fetch('https://api.oopay.me/v1/qr/generate', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
type: 'static',
amount: 500,
description: 'Оплата товара'
})
});
const qrData = await qr.json();
// qrData.qr_image - base64 изображение QR кодаWebhooks
Webhooks позволяют получать уведомления о событиях в режиме реального времени:
// Обработка webhook уведомлений
app.post('/webhook', (req, res) => {
const signature = req.headers['x-oopay-signature'];
const payload = JSON.stringify(req.body);
// Проверка подписи
const isValid = verifySignature(payload, signature, SECRET_KEY);
if (isValid && req.body.event === 'payment.success') {
const { payment_id, amount, status } = req.body.data;
// Обработка успешного платежа
processPayment(payment_id, amount);
res.status(200).send('OK');
}
});События webhook:
payment.success- платеж успешно проведёнpayment.failed- платеж отклонёнpayment.pending- платеж в обработке
Интеграция на веб-сайт
Пример интеграции платежной формы на ваш сайт:
HTML форма
Простая интеграция через форму
JavaScript SDK
Библиотека для быстрой интеграции
Плагины CMS
Готовые решения для популярных CMS
Мобильная интеграция
OOPay предоставляет SDK для iOS и Android приложений:
Безопасность и сертификация
OOPay сертифицирован по стандарту PCI DSS Level 1 и использует современные методы шифрования для защиты данных:
- Шифрование всех данных с использованием TLS 1.3
- Регулярные аудиты безопасности и пентесты
- Соответствие требованиям ЦБ РФ для платежных систем
- Мониторинг подозрительной активности 24/7
Нужна помощь?
Наша команда поддержки готова помочь вам с интеграцией