tbank

PyPI Python License: MIT

Асинхронный и синхронный Python SDK для API Т-Банка (ex-Тинькофф).

Один пакет — оба мира Т-Банка: интернет-эквайринг (приём платежей, СБП, рекуррент, фискализация 54-ФЗ) и открытый банковский API Т-Бизнеса (счета, выписки, рублёвые платежи, инвойсы, СБП-ссылки). Всё на общем типизированном ядре.

Особенности

  • 🚀 Async и sync — один API в двух вариантах на общем ядре (httpx).

  • 🛡️ Строгая типизация — pydantic v2, mypy --strict, py.typed.

  • 🔌 Полное покрытие — эквайринг (EACQ) и открытый банк (T-API) в одном пакете.

  • 🔐 Аутентификация из коробки — SHA-256 Token-подпись, Bearer и mTLS.

  • 💸 Корректные деньги — копейки (int) для эквайринга, Decimal для открытого банка.

  • 🔁 Надёжность — ретраи с бэкоффом, идемпотентность.

Установка

pip install tbank

Быстрый пример

from tbank.acquiring import AcquiringClient
from tbank.acquiring.models import InitRequest

async with AcquiringClient(terminal_key="...", password="...") as client:
    payment = await client.init(InitRequest(amount=150000, order_id="A-1"))
    print(payment.payment_url)   # редиректим покупателя

Домены

Пакет

Что покрыто

tbank.acquiring

Приём платежей, вебхуки, рекуррент, карты, СБП QR, фискализация 54-ФЗ, привязка карт

tbank.business

Счета и балансы, выписки, рублёвые платежи через mTLS, инвойсы, СБП-ссылки b2b

tbank.dolyame

Оплата частями (BNPL): жизненный цикл заказа, возвраты, доставка

tbank.tid

T-ID: вход через Т-Банк (OAuth 2.0/OIDC), учётные данные, документы, статусы, компания, делегированная идентификация

tbank.selfemployed

Выплаты самозанятым (e2c): анкеты, платёжные реестры, подписание, оплата, чеки

tbank.salary

Зарплатный проект: анкеты сотрудников, платёжные реестры, создание/подписание/оплата/отмена

tbank.nominal_accounts

Номинальные счета: бенефициары и реквизиты, скоринг, сделки/этапы/депоненты/реципиенты, платежи, балансы, холды, переводы

tbank.direct_debit

Безакцептные списания: соглашения, правила (рекуррентные и триггерные), платёжные требования

tbank.overnight

Овернайты: сводка по счёту, пополнение

tbank.special_accounts

Специальные счета: аресты средств и картотеки ЭТП

tbank.merchant_acquiring

Торговый (POS) эквайринг: терминалы и операции по ним

tbank.business_cards

Бизнес-карты: выпуск/перевыпуск виртуальных карт, реквизиты, лимиты, блокировка

tbank.delivery

Партнёрская доставка: задания, встречи и интервалы, документы (загрузка/скачивание)

tbank.tax_consult

Налоговые консультации: заявки, чат, вложения, переходы воркфлоу

tbank.deposit

Депозиты: карточка счёта, открытие и пополнение

tbank.ved

ВЭД (валютный контроль): постановка/изменение/снятие контракта, статус (HTTP-подпись)

tbank.mails

Письма (H2H): входящие письма, отметка о прочтении, непрочитанные

tbank.files

Файловое хранилище: загрузка и скачивание файлов

tbank.shopping

Шопинг — чаты магазина: чаты, сообщения, файлы

Ссылки