yookassa

What it is and what it does

Yookassa is an official Python SDK for the YooKassa payment API, a Russian payment processing service. It provides a structured interface to create payments, manage refunds, retrieve transaction history, and configure account settings through YooKassa's REST API. The library abstracts HTTP communication and response parsing, offering domain models for payments, receipts, and account data.

The package is maintained by YooMoney and supports modern Python versions (3.7–3.12). Version 3.x introduced breaking changes to the import structure compared to 2.x, so migrating projects require updating import paths. It has no external runtime dependencies, meaning installation is straightforward but you must provide your own HTTP client setup if needed beyond what the library provides.

Use it for:

• Integrate YooKassa payments into a Django or Flask web application for processing customer transactions.
• Build a payment dashboard that retrieves and displays transaction history and refund status.
• Automate recurring billing or payout operations using the YooKassa API from a backend service.
• Handle payment callbacks and reconciliation by querying payment status and receipt data.
• Manage multi-currency or split-payment scenarios using YooKassa's advanced payment data models.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python client library for integrating YooKassa payment processing API into applications, handling payment creation, retrieval, refunds, and account management.

Yes, if you are building on YooKassa's payment infrastructure. The library is actively maintained, permissively licensed, and supports current Python versions. High install friction is a minor concern given zero runtime dependencies. Verify that async support and error-handling behavior match your application's needs before committing.

Install

yookassa on PyPI

pip install yookassa

uv add yookassa

poetry add yookassa

Installing yookassa

Before you install

High install friction due to no runtime dependencies, but active maintenance with a release dated 2026-08-13 suggests ongoing support. Supports Python 3.7 through 3.12.

License in practice

MIT license (permissive) allows commercial and private use with minimal restrictions; suitable for most integration scenarios.

Quickstart

pip install yookassa

import yookassa
from yookassa import Configuration

Configuration.configure('account_id', 'secret_key')

Requires Python 3.7 or later; YooKassa account credentials (account ID and secret key or OAuth token) needed for API calls.

Verify before relying

• Whether the package handles network errors and retries automatically or requires manual error handling.
• Performance characteristics when handling high-volume payment operations.
• Whether webhook/callback handling for payment notifications is included in the SDK.
• Compatibility with async/await patterns or if it is synchronous-only.

Package facts

Evidence: yookassa-3.12.1.tar.gz

Keywords: yoomoney, yookassa, payout, sdk, python

Tags

More WWW/HTTP packages