YooKassa API Python Client Library

Russian | English

This product is used for managing payments under The YooKassa API For usage by those who implemented YooKassa using the API method.

Features

Version 3.x supports Python >=3.7. To work on earlier versions of Python, use versions of yookassa 2.x
Changing the directory/file structure affected some package imports. When switching from the version of yookassa 2.x, check the imports in your project:
- yookassa.domain.models.airline → yookassa.domain.models.payment_data.request.airline
- yookassa.domain.models.authorization_details → yookassa.domain.models.payment_data.response.authorization_details
- yookassa.domain.models.receipt_customer → yookassa.domain.models.receipt_data.receipt_customer
- yookassa.domain.models.receipt_item → yookassa.domain.models.receipt_data.receipt_item
- yookassa.domain.models.receipt_item_supplier → yookassa.domain.models.receipt_data.receipt_item_supplier
- yookassa.domain.models.recipient → yookassa.domain.models.payment_data.recipient
- yookassa.domain.models.refund_source → yookassa.domain.models.refund_data.refund_source
Settings.get_account_settings() now returns the Me object. To support compatibility, object fields can be accessed as an array - me.account_id = me['account_id']
The me.fiscalization_enabled field is deprecated, but it is still supported. The me.fiscalization object has been added instead..

Requirements

Python >=3.7
pip

Installation

Under console using pip

Install pip.
In the console, run the following command:

pip install --upgrade yookassa

Under console using easy_install

Install easy_install.
In the console, run the following command:

easy_install --upgrade yookassa

Commencing work

Import module

import yookassa

Configure a Client

from yookassa import Configuration

Configuration.configure('<Account Id>', '<Secret Key>')

from yookassa import Configuration

Configuration.account_id = '<Account Id>'
Configuration.secret_key = '<Secret Key>'

or via oauth

from yookassa import Configuration

Configuration.configure_auth_token('<Oauth Token>')

If you agree to participate in the development of the SDK, you can submit data about your framework, cms or module:

from yookassa import Configuration
from yookassa.domain.common.user_agent import Version

Configuration.configure('<Account Id>', '<Secret Key>')
Configuration.configure_user_agent(
    framework=Version('Django', '2.2.3'),
    cms=Version('Wagtail', '2.6.2'),
    module=Version('Y.CMS', '0.0.1')
)

Call the required API method. More details in our documentation for the YooKassa API

Release files for yookassa 3.12.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for yookassa 3.12.1
File	Size	Uploaded
yookassa-3.12.1.tar.gz	147.9 kB	Aug 13, 2026	Details

Release files / yookassa-3.12.1.tar.gz

Download URL	yookassa-3.12.1.tar.gz
Size	147.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`02ac55463440f07026cdb81db74a7a983c36150b57dc02d0909626c3509bd128`
BLAKE2b-256 checksum How to use checksums	`4759c3936ec9dac6d71339a0031c8496db9fa9419a298fd2f995145d11446fc3`
Upload date	Aug 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`