Changelog

1.14.0

  • Рефакторинг доменов: декларации Endpoint вынесены в модуль _endpoints.py каждого домена и переиспользуются sync/aio-клиентами.

  • Ядро: адреса хостов централизованы в tbank.core.urls; транспорты собираются фабриками build_sync_transports / build_async_transports.

  • Ядро: единый разбор T-API error-ответов — error_from_tapi_response в tbank.core.errors; доменные errors.py сведены к тонким обёрткам.

  • Ядро (client): хелперы dump_model, parse_as (поддержка TypeAdapter для списков и oneOf), page_params, ensure_idempotency_key; флаг decimal_body для парсинга денежных сумм в Decimal; _call принимает словарь и валидирует его через request_model эндпоинта.

  • Ретраи: неидемпотентные запросы (POST без Idempotency-Key) по умолчанию не повторяются (кроме 429), опция RetryPolicy.retry_non_idempotent; задержка учитывает Retry-After в секундах и в формате HTTP-даты.

1.13.0

  • Новый домен tbank.mails — внутренние письма H2H: push_incoming_mail (mTLS + подпись), mark_read, list_unread.

  • Новый домен tbank.files — файловое хранилище: upload_file и download_file (application/octet-stream, Bearer).

  • Новый домен tbank.shopping — чаты магазина: list_chats, get_chat, list_messages, send_message, upload_chat_file, download_chat_file (mTLS).

  • Ядро: HTTP-подпись вынесена в tbank.core.signing.HttpSignature и переиспользуется валютным контролем и письмами (tbank.ved.CurrencySignature — псевдоним).

1.12.0

  • Новый домен tbank.ved — ВЭД / валютный контроль (4 метода): register_contract, amend_contract, deregister_contract и get_application_status.

    • Постановка/изменение/снятие идут на secured-хост (mTLS) и подписываются по схеме HTTP Signatures (HMAC-SHA256) через CurrencySignature(key_id, secret); статус — по Bearer. Целочисленные перечисления контракта уходят числами.

    • Подпись реализована по стандарту draft-cavage — точная сборка строки подписи в спеке не приведена, требует сверки с реальным ключом.

1.11.0

  • Новый домен tbank.deposit — депозиты (3 метода): get_deposit_details (баланс, ставка, условия, автопролонгация), open_deposit и replenish_deposit. На secured-хосте по mTLS; суммы — Decimal в валюте депозита.

1.10.0

  • Новый домен tbank.tax_consult — налоговые консультации (13 методов):

    • Заявка и чат: get_request, get_chat, send_message.

    • Вложения: upload_attachment (octet-stream), download_attachment (байты).

    • Воркфлоу (оптимистичная блокировка через If-Match/cas_version): start_review, start_work, request_clarification, decline, cancel, set_pending_payment, confirm_payment, mark_ready.

    • Весь домен — на secured-хосте по mTLS.

  • Ядро: транспорт теперь поддерживает и content (binary-тело) — для application/octet-stream-запросов.

1.9.0

  • Новый домен tbank.delivery — партнёрская доставка (8 методов):

    • Задания: create_task (с Idempotency-Key), get_task, update_task, cancel_task.

    • Встречи: get_intervals (подбор интервалов по адресу), create_meeting.

    • Документы: upload_document (multipart/form-data) и download_document (сырые байты).

  • Ядро: транспорт (AsyncTransport/SyncTransport) теперь поддерживает data/files для multipart/form-data-запросов.

1.8.0

  • Новый домен tbank.business_cards — бизнес-карты (14 методов):

    • Карты: list_cards, get_card, get_virtual_card_requisites, block_card, list_company_cards (v3).

    • Выпуск виртуальных карт: create_virtual_card_application, get_virtual_card_application, list_virtual_card_applications (v3); перевыпуск — reissue_virtual_card + get_reissue_result.

    • Лимиты: get_card_limits, set_cash_limit, set_spend_limit, set_batch_limits (пакетно, до 10 000 карт).

    • Перевыпуск, расходный лимит, пакетные лимиты и методы v3 — на secured-хосте по mTLS, остальное — по Bearer. Суммы — Decimal в рублях.

1.7.0

  • Новый домен tbank.merchant_acquiring — торговый (POS) эквайринг: list_terminals (постранично) и list_operations (операции по терминалу за период). Обычный хост по Bearer; суммы — в копейках (int). Отдельный API от интернет-эквайринга tbank.acquiring.

1.6.0

  • Новый домен tbank.overnight — овернайты (размещение остатка счёта на ночь): get_overnight_info (сумма, ставка, автоплатёж, текущая сделка, настройки) и replenish_overnight. На secured-хосте по mTLS; суммы T-API отдаёт строками.

  • Новый домен tbank.special_accounts — специальные счета: get_arrest_etp_operations (аресты средств и картотеки ЭТП за период). На обычном хосте по Bearer; суммы — Decimal в рублях.

1.5.0

  • Новый домен tbank.direct_debit — безакцептные списания (15 методов):

    • Соглашения: list_agreements, get_agreement, get_agreement_file (PDF), get_agreement_url (ссылка на подписание контрагентом).

    • Правила: create_rule (рекуррентное RecurrentRuleCreate по cron или триггерное TriggerRuleCreate по факту пополнения), get_rule/update_rule (карточка — дискриминированное объединение Recurrent/Trigger), delete_rule, list_rules, list_rules_v2.

    • Платёжные требования: create_payment_request, list_payment_requests, get_payment_request, revoke_payment_request, get_payment_request_file (PDF).

    • Весь домен — на secured-хосте по mTLS. Создание/отзыв — с Idempotency-Key. Суммы — Decimal в рублях.

1.4.0

  • Новый домен tbank.nominal_accounts — номинальные счета (48 методов):

    • Бенефициары: create_beneficiary, get_beneficiary, update_beneficiary, list_beneficiaries; типы бенефициаров (ФЛ/ИП/ЮЛ, резидент/нерезидент, lite) — дискриминированное объединение по type.

    • Банковские реквизиты бенефициара (РКЦ/карта/СБП): create_bank_details, get_bank_details, update_bank_details, delete_bank_details, set_default_bank_details, list_bank_details; запросы на добавление карты (create_add_card_request, get_add_card_request) и скоринг (get_beneficiaries_scoring).

    • Сделки и этапы: create_deal/get_deal/delete_deal/accept_deal/cancel_deal/ draft_deal/get_deal_validity/list_deals; create_step/get_step/ update_step/delete_step/complete_step/list_steps; депоненты и реципиенты этапа с обновлением реквизитов реципиента.

    • Платежи (обычные и налоговые), балансы, холды, неидентифицированные пополнения (identify_incoming_transaction) и переводы между виртуальными счетами.

    • Просмотр карточек сделки/этапа/платежа, проверка сделки и переводы — на secured-хосте по mTLS, остальное — по Bearer. Создание ресурсов — с Idempotency-Key. Суммы — Decimal в рублях.

1.3.0

  • Новый домен tbank.salary — зарплатный проект:

    • Сотрудники: add_employees_by_requisites, create_employees (черновики анкет), list_employees + опрос результатов.

    • Платёжные реестры: create_payment_registry, create_and_submit_registry (создать и подписать одним вызовом), submit_payment_registry, pay_payment_registry, cancel_payment_registry + опрос результатов; list_payment_registries, get_payment_registry.

    • Async-модель через клиентский correlationId (оплата — ключ идемпотентности id). Подписание/оплата/отмена/список реестров — на secured-хосте по mTLS, анкеты и создание черновика — на обычном хосте по Bearer. Суммы — Decimal в рублях.

1.2.0

  • Новый домен tbank.selfemployed — выплаты самозанятым (e2c):

    • Самозанятые: create_recipients (черновики анкет), add_recipients_by_requisites, list_recipients + опрос результатов get_*_result.

    • Платёжные реестры: create_payment_registry, подписание submit_payment_registry, оплата pay_payment_registry, чеки request_receipts + опрос результатов; list_payment_registries, get_payment_registry.

    • Async-модель submit→pay→result через клиентский correlationId (генерируется автоматически). Подписание/оплата/чеки/список реестров — на secured-хосте по mTLS, анкеты и создание реестра — на обычном хосте по Bearer. Суммы — Decimal в рублях.

1.1.0

  • Новый домен tbank.tid — T-ID:

    • Вход через Т-Банк по OAuth 2.0 / OIDC (TidOAuth): build_authorization_url (в т.ч. PKCE), fetch_token, refresh_token, fetch_client_credentials_token, introspect, revoke, get_userinfo на id.tbank.ru.

    • Data-эндпоинты (TidClient): учётные данные, ИНН/СНИЛС, паспорт, водительские удостоверения, адреса, дебетовые счета; статусы идентификации, самозанятости, иностранного агента, ПДЛ и чёрных списков; информация о компании (T-Business ID) и делегированная идентификация.

  • Эквайринг: альтернативная оплата и служебные методы — get_tinkoff_pay_status, get_tinkoff_pay_link, get_tinkoff_pay_qr, get_sber_pay_link, get_sber_pay_qr, get_mir_pay_deeplink, check_order, resend.

1.0.0

Стабильный релиз.

  • Новый домен tbank.dolyame — оплата частями (BNPL): жизненный цикл заказа (create_order, get_order, commit, cancel, refund, correction, complete_delivery), вебхуки, аутентификация mTLS + HTTP Basic.

  • Полная документация (Sphinx + readthedocs): гайды по аутентификации, ошибкам и вебхукам, справочник всех методов и моделей (autodoc-pydantic).

0.1.0

Первый релиз.

Эквайринг (tbank.acquiring, EACQ):

  • Приём платежей: init, get_state, confirm, cancel.

  • Вебхуки: разбор и проверка подписи (parse_notification, verify_notification).

  • Рекуррент: charge (по RebillId), поле recurrent в init.

  • Клиенты и карты: add_customer, get_customer, remove_customer, get_card_list, remove_card.

  • СБП QR: get_qr, get_qr_members; СБП-рекуррент: add_account_qr, get_add_account_qr_state, charge_qr.

  • Фискализация 54-ФЗ: объект Receipt в init/charge/charge_qr, send_closing_receipt.

  • Привязка карт: add_card, get_add_card_state; статус возврата СБП get_qr_state.

Открытый банк (tbank.business, T-API):

  • Счета и выписки: get_accounts, get_statement, iter_statement (курсорная авто-пагинация), get_bank_statement.

  • Рублёвые платежи через mTLS: create_ruble_payment (с налоговым блоком), get_payment_status, get_documents_status.

  • Инвойсы: send_invoice, get_invoice_info.

  • СБП-ссылки b2b: create_onetime_qr, create_reusable_qr, get_qr_info.

Ядро:

  • Async и sync транспорт на httpx, ретраи с бэкоффом.

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

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