Skip to main content

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

Click — широко используемая платёжная система в Узбекистане. Это руководство показывает, как интегрировать Click с PayTechUZ.

Установка​

pip install paytechuz

Базовое использование​

Создание шлюза​

import os
from paytechuz.gateways.click import ClickGateway

gateway = ClickGateway(
    service_id="your_service_id",
    merchant_id="your_merchant_id",
    merchant_user_id="your_merchant_user_id",
    secret_key="your_secret_key",
    is_test_mode=True,  # True для теста, False для продакшена)

Создание платежа​

payment = gateway.create_payment(
    id="12345",          # ID счёта
    amount=500.00,       # сумма в UZS
    return_url="https://example.com/return"
)

print(f"Payment URL: {payment}")
# Перенаправьте пользователя на URL платежа

Проверка статуса платежа​

status = gateway.check_payment("transaction_id")
print(f"Status: {status['status']}")

Вебхук​

from paytechuz.gateways.click.webhook import ClickWebhookHandler

webhook_handler = ClickWebhookHandler(
    service_id="your_service_id",
    secret_key="your_secret_key"
)

def process_webhook(request_data):
    response = webhook_handler.handle_webhook(request_data)

    if response['error'] == 0:
        # Платёж успешен
        print("Платёж успешен!")

    return response

Интеграция с Django​

Settings.py​

INSTALLED_APPS = [
    # ...
    'paytechuz.integrations.django',
]

PAYTECHUZ = {
    'CLICK': {
        'SERVICE_ID': 'your_service_id',
        'MERCHANT_ID': 'your_merchant_id',
        'MERCHANT_USER_ID': 'your_merchant_user_id',
        'SECRET_KEY': 'your_secret_key',
        'ACCOUNT_MODEL': 'shop.models.Order',
        'ACCOUNT_FIELD': 'id',
        'AMOUNT_FIELD': 'amount',
        'IS_TEST_MODE': True,
    }
}

Views.py​

from paytechuz.integrations.django.views import BaseClickWebhookView
from .models import Order

class ClickWebhookView(BaseClickWebhookView):
    def successfully_payment(self, params, transaction):
        order = Order.objects.get(id=transaction.account_id)
        order.status = 'paid'
        order.save()

    def cancelled_payment(self, params, transaction):
        order = Order.objects.get(id=transaction.account_id)
        order.status = 'cancelled'
        order.save()

URLs.py​

from django.urls import path
from .views import ClickWebhookView

urlpatterns = [
    path('webhooks/click/', ClickWebhookView.as_view(), name='click_webhook'),
]

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

from fastapi import FastAPI, Request
from paytechuz.gateways.click import ClickGateway
from paytechuz.integrations.fastapi import ClickWebhookHandler
import os

app = FastAPI()

# Создание шлюза
click = ClickGateway(
    service_id=os.getenv('CLICK_SERVICE_ID'),
    merchant_id=os.getenv('CLICK_MERCHANT_ID'),
    merchant_user_id=os.getenv('CLICK_MERCHANT_USER_ID'),
    secret_key=os.getenv('CLICK_SECRET_KEY'),
    is_test_mode=True
)

@app.post("/payment/create")
async def create_payment():
    payment_url = click.create_payment(
        id="12345",
        amount=500.00,
        return_url="https://example.com/return"
    )
    return {"payment_url": payment_url}

@app.post("/webhooks/click")
async def webhook(request: Request):
    handler = ClickWebhookHandler(
        service_id=os.getenv('CLICK_SERVICE_ID'),
        secret_key=os.getenv('CLICK_SECRET_KEY'),
        account_model=Order
    )
    return await handler.handle_webhook(request)

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

Тестовый режим​

Для тестирования используйте эти данные:

  • Service ID: test_service_id
  • Merchant ID: test_merchant_id
  • Тестовая карта: 8600 0691 9540 6311

Продакшен режим​

  1. Зарегистрируйтесь на Click Business
  2. Получите ваши продакшен данные
  3. Установите is_test_mode=False

Обработка ошибок​

from paytechuz.exceptions import ClickException

try:
    payment = gateway.create_payment(
        id="12345",
        amount=500.00,
        return_url="https://example.com/return"
    )
except ClickException as e:
    print(f"Ошибка Click: {e}")

Коды ответов вебхука​

Click вебхук ожидает определённые коды ответов:

  • 0 - Успех
  • -1 - Ошибка проверки подписи
  • -2 - Неверный параметр суммы
  • -3 - Действие не найдено
  • -4 - Уже оплачено
  • -5 - Пользователь не существует
  • -6 - Транзакция не существует
  • -7 - Не удалось обновить пользователя
  • -8 - Ошибка в запросе от Click
  • -9 - Транзакция отменена

Дополнительная информация​