---
id: yookassa
version: "3.12.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# yookassa — YooKassa API SDK Python Library

License: permissive · Maintenance: active · Downloads: 121.8K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: active
- Downloads: 121.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

yookassa payment api client, python payment gateway sdk, yoomoney payment integration, payment processing library python, yookassa refund management, payment api wrapper python, yookassa account settings, payment-processing, yoomoney, api-client

[View on SkillFed](https://skillfed.io/packages/yookassa) · [View on PyPI](https://pypi.org/project/yookassa/)