Интеграция с FastAPI

Полное руководство по интеграции PayTechUZ с приложениями FastAPI.

Установка

Установите PayTechUZ с поддержкой FastAPI:

pip install paytechuz[fastapi]

Конфигурация

Настройте модели базы данных:

from datetime import datetime, timezone

from sqlalchemy.orm import sessionmaker
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy import create_engine, Column, Integer, String, Float, DateTime

from paytechuz.integrations.fastapi import Base as PaymentsBase
from paytechuz.integrations.fastapi.models import run_migrations

# Создание движка базы данных
SQLALCHEMY_DATABASE_URL = "sqlite:///./payments.db"
engine = create_engine(SQLALCHEMY_DATABASE_URL)

# Создание базового декларативного класса
Base = declarative_base()

# Создание модели Order
class Order(Base):
    __tablename__ = "orders"

    id = Column(Integer, primary_key=True, index=True)
    product_name = Column(String, index=True)
    amount = Column(Float)
    status = Column(String, default="pending")
    created_at = Column(DateTime, default=lambda: datetime.now(timezone.utc))

# Создание таблиц платежей с помощью run_migrations
run_migrations(engine)

# Создание таблицы Order
Base.metadata.create_all(bind=engine)

# Создание сессии
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)

Создание обработчиков webhook:

from fastapi import FastAPI, Request, Depends

from sqlalchemy.orm import Session

from paytechuz.integrations.fastapi import PaymeWebhookHandler, ClickWebhookHandler


app = FastAPI()

# Зависимость для получения сессии базы данных
def get_db():
    db = SessionLocal()
    try:
        yield db
    finally:
        db.close()

class CustomPaymeWebhookHandler(PaymeWebhookHandler):
    def successfully_payment(self, params, transaction):
        # Обработка успешного платежа
        order = self.db.query(Order).filter(Order.id == transaction.account_id).first()
        order.status = "paid"
        self.db.commit()

    def cancelled_payment(self, params, transaction):
        # Обработка отменённого платежа
        order = self.db.query(Order).filter(Order.id == transaction.account_id).first()
        order.status = "cancelled"
        self.db.commit()

class CustomClickWebhookHandler(ClickWebhookHandler):
    def successfully_payment(self, params, transaction):
        # Обработка успешного платежа
        order = self.db.query(Order).filter(Order.id == transaction.account_id).first()
        order.status = "paid"
        self.db.commit()

    def cancelled_payment(self, params, transaction):
        # Обработка отменённого платежа
        order = self.db.query(Order).filter(Order.id == transaction.account_id).first()
        order.status = "cancelled"
        self.db.commit()

@app.post("/payments/payme/webhook")
async def payme_webhook(request: Request, db: Session = Depends(get_db)):
    handler = CustomPaymeWebhookHandler(
        db=db,
        payme_id="your_merchant_id",
        payme_key="your_merchant_key",
        account_model=Order,
        account_field='id',
        amount_field='amount'
    )
    return await handler.handle_webhook(request)

@app.post("/payments/click/webhook")
async def click_webhook(request: Request, db: Session = Depends(get_db)):
    handler = CustomClickWebhookHandler(
        db=db,
        service_id="your_service_id",
        merchant_id="your_merchant_id",
        secret_key="your_secret_key",
        account_model=Order
    )
    return await handler.handle_webhook(request)

Создание ссылки для оплаты

from paytechuz.gateways.payme import PaymeGateway
from paytechuz.gateways.click import ClickGateway

# Получение заказа
order = db.query(Order).filter(Order.id == 1).first()

# Создание ссылки для оплаты Payme
payme = PaymeGateway(
    payme_id='your_payme_id',
    payme_key='your_payme_key',
    is_test_mode=True  # Установите False в продакшене
)
payme_link = payme.create_payment(
    id=order.id,
    amount=order.amount,
    return_url="https://example.com/return"
)

# Создание ссылки для оплаты Click
click = ClickGateway(
    service_id='your_click_service_id',
    merchant_id='your_click_merchant_id',
    merchant_user_id='your_click_merchant_user_id',
    secret_key='your_click_secret_key',
    is_test_mode=True  # Установите False в продакшене
)
click_link = click.create_payment(
    id=order.id,
    amount=order.amount,
    return_url="https://example.com/return"
)

Полный пример

Для полного рабочего приложения FastAPI с интеграцией PayTechUZ, ознакомьтесь с нашим примером проекта:

🔗 Пример интеграции FastAPI - Полный проект FastAPI с обработкой платежей

Этот пример включает:

• ✅ Полная настройка приложения
• ✅ Модели базы данных и миграции
• ✅ Интеграция платёжного шлюза
• ✅ Обработчики webhook
• ✅ API endpoints
• ✅ Обработка ошибок

Следующие шаги

• Пример проекта FastAPI - Полный рабочий пример
• Начало работы - Базовое руководство по установке
• Интеграция с Django - Интеграция с альтернативным фреймворком