async_yookassa 0.3.0

Unofficial API client for YooKassa

Async YooKassa (unofficial)

Неофициальный клиент для работы с платежами по API ЮKassa

За основу взята официальная библиотека от ЮМани.

Цель

Заменить синхронный requests на асинхронный httpx, также переложить валидацию данных на Pydantic.

Реализовано на данный момент

• Pydantic-модели для объектов платежа.
• Класс Configuration.
• Класс APIClient.
• Класс Payment.
• Класс Invoice.
• Класс Refund.
• Класс Receipt.

Требования

1. Python >=3.12
2. pip/poetry

Установка

C помощью pip

1. Установите pip.
2. В консоли выполните команду

pip install --upgrade async_yookassa

C помощью poetry

1. Установите poetry.
2. В консоли выполните команду

poetry add async_yookassa

Начало работы

1. Импортируйте модуль

import async_yookassa

2. Установите данные для конфигурации

from async_yookassa import Configuration

Configuration.configure(account_id='<Идентификатор магазина>', secret_key='<Секретный ключ>')

или

from async_yookassa import Configuration

Configuration.account_id = '<Идентификатор магазина>'
Configuration.secret_key = '<Секретный ключ>'

или через oauth

from async_yookassa import Configuration

Configuration.configure_auth_token(token='<Oauth Token>')

Если вы согласны участвовать в развитии SDK, вы можете передать данные о вашем фреймворке, cms или модуле:

from async_yookassa import Configuration
from async_yookassa.models.configuration_submodels.version import Version

Configuration.configure('<Идентификатор магазина>', '<Секретный ключ>')
Configuration.configure_user_agent(
    framework=Version(name='Django', version='2.2.3'),
    cms=Version(name='Wagtail', version='2.6.2'),
    module=Version(name='Y.CMS', version='0.0.1')
)

3. Вызовите нужный метод API. Подробнее в документации к API ЮKassa