Интеграция сервиса онлайн оплаты CLICK SHOP API и Merchant API через фреймворк Django в Python

С помощью пакет python-click вы сможете очень легко интегрировать платежную систему CLICK. В этом руководстве показано, как интегрировать систему оплаты CLICK SHOP API и Merchant API. Через этот пакет вы сможете получать платежи за различные товары, услуги и покупки в Интернет Магазине. Более подробная информация об интеграции находится на официальной документации OOO "Click"

Необходимые пакеты

Django - свободный фреймворк для веб-приложений на языке Python, использующий шаблон проектирования MVC.

Django REST framework - это мощный и гибкий инструментарий для создания веб-приложений.

Requests - это элегантная и простая HTTP-библиотека для Python, созданная для людей.

Установка

Установите с помощью pip, включая любые дополнительные пакеты, которые вы хотите...

pip install python-click

...или клонируйте проект с github

git clone https://github.com/yakubov9791999/python-click.git

Поместите это в settings.py

INSTALLED_APPS = [
    ...
    'pyclick',
    'rest_framework',
]

CLICK_SETTINGS = {
    'service_id': "<Ваш сервис ID>",
    'merchant_id': "<Ваш merchant ID>",
    'secret_key': "<Ваш секретный ключ>",
    'merchant_user_id': "<Ваш merchant user ID>",
}

Примечание: Эти информации будет предоставлена ​​вам после того, как вы подписали контракт с OOO «Click»

Добавьте следующее в свой корневой каталог urls.py файл.

from django.urls import include

urlpatterns = [
    ...
    path('pyclick/', include('pyclick.urls')),
]

Выполните команды makemigrations и migrate

python manage.py makemigrations
python manage.py migrate

Настройка биллинг

Введите Prepare URL (Адрес проверки) и Complete URL (Адрес результата) на сайт merchant.click.uz, чтобы система CLICK проверил ваш заказ.

Prepare URL

https://example.com/pyclick/process/click/transaction/?format=json

Complete URL

https://example.com/pyclick/process/click/transaction/?format=json

Создать заказ

Вы можете создать заказ через администратора django или по этой ссылке http://127.0.0.1:8000/pyclick/process/click/transaction/create/

Поместите желаемую сумму в поле amount и создайте заказ.

CLICK SHOP API

Обратите внимание, что после создания заказа по этой ссылке http://127.0.0.1:8000/pyclick/process/click/transaction/create/ мы перейдем на сайт http://my.click.uz.

Вы можете оплатить, введя номер карты или номер телефона.

Полная информация, локальное тестирование, реальная интеграция с системой CLICK SHOP API, настройка личного кабинета и для проверки заказа через систему Merchant CLICK вы можете найти по этой ссылке https://pypi.org/project/python-click/0.1/ или в этом видео

CLICK Merchant API

Создать инвойс (счет-фактуру)

POST http://127.0.0.1:8000/pyclick/process/click/service/create_invoice

Body:

phone_number - Номер телефона

transaction_id - ID заказа

---

Проверка статуса инвойса (счет-фактуры)

POST http://127.0.0.1:8000/pyclick/process/click/service/check_invoice

Body:

invoice_id - ID инвойса

transaction_id - ID заказа

---

Создание токена карты

POST http://127.0.0.1:8000/pyclick/process/click/service/create_card_token

Body:

card_number - Номер карты

expire_date - Срок карты

temporary - создать токен для единичного использования. Временные токены автоматически удаляются после оплаты.

transaction_id - ID заказа

---

Подтверждение токена карты

POST http://127.0.0.1:8000/pyclick/process/click/service/verify_card_token

Body:

card_token - Токен карты

sms_code - Полученный смс код

transaction_id - ID заказа

---

Оплата с помощью токена

POST http://127.0.0.1:8000/pyclick/process/click/service/payment_with_token

Body:

card_token - Токен карты

transaction_id - ID заказа

---

Удаление токена карты

POST http://127.0.0.1:8000/pyclick/process/click/service/delete_card_token

Body:

card_token - Токен карты

---

Снятие платежа (отмена)

POST http://127.0.0.1:8000/pyclick/process/click/service/cancel_payment

Body:

transaction_id - ID заказа

---

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

POST http://127.0.0.1:8000/pyclick/process/click/service/check_payment_status

Body:

transaction_id - ID заказа

---

Вы можете отправить эти запросы через Postman. Загрузите эту коллекцию и импортируйте ее в свой postman. В этой коллекции все запросы и обязательные поля написано.

Для более подробной информации, создание заказа, production интеграция с системой CLICK SHOP API и Merchant API, настройка личного кабинета и для проверки заказа через систему Merchant CLICK, вы можете посмотреть это видео

Спасибо за внимание!

Автор

Sirojiddin Yakubov

Социальные сети

Подпишитесь на нас, чтобы получать больше новостей о веб-программировании:
YouTube | Instagram | Facebook | TikTok | Telegram