rupay
Единая Python-библиотека для работы с российскими платежными системами
Простая интеграция с ЮMoney, QIWI, Tinkoff, ЮKassa и СберБанк через единый интерфейс.
💰 Поддержите проект
Если библиотека сэкономила ваше время — поддержите разработку!
Ваши донаты помогают:
✅ Поддерживать библиотеку актуальной
✅ Добавлять новые платежные системы
✅ Улучшать документацию
✅ Быстрее отвечать на issues
🚀 Возможности
- Единый API для всех платежных систем
- 5 платежных систем: ЮMoney, QIWI, Tinkoff, ЮKassa, СберБанк
- Async/await поддержка для высокой производительности
- Type hints для удобной разработки
- Простая интеграция — всего несколько строк кода
- Webhook обработка для автоматизации
- Подробная документация на русском языке
📦 Установка
pip install rupay
🔧 Быстрый старт
ЮMoney (Яндекс.Деньги)
from rupay import YooMoneyClient
# Инициализация клиента
client = YooMoneyClient(token="your_token_here")
# Создание платежа
payment = client.create_payment(
amount=100.0,
description="Оплата заказа #123",
return_url="https://yoursite.com/success"
)
print(f"Ссылка для оплаты: {payment['confirmation_url']}")
# Проверка статуса
status = client.get_payment_status(payment['id'])
print(f"Статус: {status['status']}")
QIWI
from rupay import QiwiClient
# Инициализация
client = QiwiClient(token="your_qiwi_token", phone="+79001234567")
# Проверка баланса
balance = client.get_balance()
print(f"Баланс: {balance['amount']} {balance['currency']}")
# История операций
history = client.get_history(rows=10)
for transaction in history:
print(f"{transaction['date']}: {transaction['sum']} руб.")
Tinkoff Acquiring
from rupay import TinkoffClient
# Инициализация
client = TinkoffClient(
terminal_key="your_terminal_key",
secret_key="your_secret_key"
)
# Создание платежа
payment = client.init_payment(
amount=150000, # сумма в копейках (1500.00 руб)
order_id="ORDER-123",
description="Оплата товара"
)
print(f"Ссылка: {payment['PaymentURL']}")
# Проверка статуса
status = client.get_state(payment['PaymentId'])
print(f"Статус: {status['Status']}")
ЮKassa 🆕
from rupay import YuKassaClient
# Инициализация
client = YuKassaClient(
shop_id="your_shop_id",
secret_key="your_secret_key"
)
# Создание платежа
payment = client.create_payment(
amount=500.0,
description="Оплата заказа",
return_url="https://yoursite.com/success"
)
print(f"Ссылка: {payment['confirmation_url']}")
# Проверка статуса
status = client.get_payment_status(payment['id'])
print(f"Статус: {status['status']}, Оплачено: {status['paid']}")
СберБанк 🆕
from rupay import SberbankClient
# Инициализация
client = SberbankClient(
username="your_username",
password="your_password"
)
# Создание платежа
payment = client.create_payment(
amount=1000.0,
description="Оплата заказа",
return_url="https://yoursite.com/success"
)
print(f"Ссылка: {payment['confirmation_url']}")
# Проверка статуса
status = client.get_payment_status(payment['id'])
print(f"Статус: {status['status']}")
🔄 Async версия
Все клиенты поддерживают асинхронную работу:
from rupay import AsyncYuKassaClient, AsyncSberbankClient
import asyncio
async def main():
# ЮKassa
yukassa = AsyncYuKassaClient(shop_id="...", secret_key="...")
payment = await yukassa.create_payment(amount=100.0, description="Test")
# СберБанк
sber = AsyncSberbankClient(username="...", password="...")
order = await sber.create_payment(amount=200.0, description="Order")
print(payment, order)
asyncio.run(main())
📚 Документация
Полная документация доступна в папке docs/:
- Руководство по ЮMoney
- Руководство по QIWI
- Руководство по Tinkoff
- Руководство по ЮKassa 🆕
- Руководство по СберБанк 🆕
- Примеры использования
🎯 Зачем rupay?
Проблема
Каждая платежная система имеет свой API:
- Разные форматы запросов
- Разная документация
- Разные методы обработки ошибок
- Много времени на интеграцию каждой системы
Решение
rupay — единый интерфейс для всех систем:
# Одинаковый код для всех платежных систем
for client in [yoomoney, qiwi, tinkoff, yukassa, sberbank]:
payment = client.create_payment(amount=100, description="Тест")
status = client.get_payment_status(payment['id'])
🛠️ Требования
- Python 3.7+
- requests >= 2.25.0
- aiohttp >= 3.7.0 (для async версии)
🎉 Что нового в v0.2.0
- ✅ Добавлена поддержка ЮKassa (YooKassa)
- ✅ Добавлена поддержка СберБанк Acquiring
- ✅ Синхронные и асинхронные версии для новых систем
- ✅ Единый интерфейс create_payment() для всех систем
- ✅ Примеры использования и документация
📄 Лицензия
MIT License — используйте свободно в любых проектах.
🐛 Нашли баг?
Создайте issue с описанием проблемы.
✨ Roadmap
- ЮKassa (YooKassa) ✅
- СберБанк Acquiring ✅
- Webhook валидация для всех систем
- CLI инструмент для быстрой проверки
- Плагины для Django/Flask
- Alfa-Bank Acquiring API
Made with ❤️ for Russian developers
Metadata
Release files for rupay 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| rupay-0.2.0.tar.gz | 30.9 kB | Without provenance | Details for rupay-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| rupay-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for rupay-0.2.0-py3-none-any.whl |
Total release size: 52.2 kB
Release files / rupay-0.2.0.tar.gz
| Download URL | rupay-0.2.0.tar.gz |
|---|---|
| Size | 30.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
231408cdf7048237498d0d1c369a681c8e95ef0d9dd2f288d29af0556b460dc1
|
|
BLAKE2b-256 checksum How to use checksums |
b4143e999c93869709cc70b3cb47ade27447c4e54486f533b3369cbd93b194b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.8
|
Release files / rupay-0.2.0-py3-none-any.whl
| Download URL | rupay-0.2.0-py3-none-any.whl |
|---|---|
| Size | 21.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4a75f66a2d4ab6f5abe5becfcf0c818c8c77a8c84d4bb1eeb9e609bb4e94f712
|
|
BLAKE2b-256 checksum How to use checksums |
91aa730fb76005c66e7b26443cb3ad17f2e75c9fb63cebc2e556a0cd7c53141f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.8
|
Security for rupay 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.