Skip to main content

rupay

PyPI version Python Versions License: MIT

Единая Python-библиотека для работы с российскими платежными системами

Простая интеграция с ЮMoney, QIWI, Tinkoff, ЮKassa и СберБанк через единый интерфейс.


💰 Поддержите проект

Если библиотека сэкономила ваше время — поддержите разработку!

DonationAlerts



Ваши донаты помогают:

✅ Поддерживать библиотеку актуальной
✅ Добавлять новые платежные системы
✅ Улучшать документацию
✅ Быстрее отвечать на 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/:

🎯 Зачем 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)

Source distribution for rupay 0.2.0
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)

Table of built distributions (wheels) for rupay 0.2.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page