xbsl-tbank-pay

Библиотека для 1С:Предприятие.Элемент, которая реализует базовый прием платежей через эквайринг T-Bank: hosted checkout и оплату через СБП по QR/payload.

Версия: 0.1.4

Требования

• 1С:Предприятие.Элемент версии 9.0 и выше
• Терминал T-Bank с полученными TerminalKey и Password

Состав репозитория

• TBankPay/ — исходный проект библиотеки. Его нужно открывать в IDE 1С:Элемент и использовать как пакет зависимости.
• DemoTBankPay/ — отдельное demo-приложение для ручной проверки сценариев.

Подключение

Добавьте библиотеку как зависимость в ваш проект:

Импорт:
    - korolevpavel::TBankPay::Основное

Если нужно открывать форму настроек из кода, добавьте также:

    - korolevpavel::TBankPay::Настройки

Заполните настройки подключения (TerminalKey и Password) через форму:

НастройкиTBankPay.СоздатьФормуЗаписи().Открыть()

Быстрый старт

Hosted checkout

импорт korolevpavel::TBankPay::Основное

знч Результат = ОплатаTBank.ИнициироватьПлатеж(
    новый ЗапросПлатежаTBank(
        ИдентификаторЗаказа = "order-1001",
        СуммаВКопейках = 19900,
        Описание = "Оплата заказа #1001",
        SuccessUrl = "https://example.com/payment/success",
        FailUrl = "https://example.com/payment/fail"
    )
)

знч UrlОплаты = Результат.UrlПлатежнойФормы

СБП

импорт korolevpavel::TBankPay::Основное

знч Результат = ОплатаTBank.ИнициироватьПлатеж(
    новый ЗапросПлатежаTBank(
        ИдентификаторЗаказа = "order-1002",
        СуммаВКопейках = 25900,
        Описание = "Оплата заказа #1002",
        СценарийОплаты = СценарийОплатыTBank.СБП
    )
)

знч PayloadСБП = Результат.QrСБП?.Payload

Что реализовано

• инициация платежа через Init
• получение QR/payload для СБП через GetQr
• polling статуса платежа через GetState
• эмуляция исходов СБП через SbpPayTest
• нормализация статусов T-Bank в СтатусПлатежаTBank
• runtime-настройки: TerminalKey, Password, базовый URL, таймауты

Что пока не реализовано

• Confirm, Cancel, возвраты
• webhook-уведомления
• передача Receipt, DATA и других расширенных блоков Init
• рекуррентные сценарии и сохранение способа оплаты

Документация

Подробное описание API, публичный контракт и инструкция по настройке: TBankPay/README.md

Инструкция по запуску и проверке demo-приложения: DemoTBankPay/README.md