Download the PHP package webmasterolegan/tbank-payments without Composer
On this page you can find all versions of the php package webmasterolegan/tbank-payments. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download webmasterolegan/tbank-payments
More information about webmasterolegan/tbank-payments
Files in webmasterolegan/tbank-payments
Package tbank-payments
Short Description PHP 8.5+ SDK для работы с API интернет-эквайринга T-Bank (Тинькофф)
License MIT
Informations about the package tbank-payments
tbank-payments
PHP 8.5+ SDK для работы с API интернет-эквайринга T-Bank (бывший Tinkoff).
Возможности
| Группа | Методы |
|---|---|
| Платежи | Init, FinishAuthorize, Confirm, Charge |
| СБП | GetQr, GetQrState, GetQrBankList, QrMembersList, ChargeQr, AddAccountQr, GetAddAccountQrState |
| Статус | GetState, CheckOrder |
| Уведомления | Resend |
| Отмена / возврат | Cancel (полный и частичный) |
| Карты | AddCard, GetCardList, RemoveCard |
| Покупатели | AddCustomer, GetCustomer, RemoveCustomer |
| Чеки (ФФД 1.2) | SendClosingReceipt |
| Webhook | Валидация подписи, типизированное уведомление |
Установка
Требования: PHP ≥ 8.5, расширения curl, json, mbstring, uri.
Быстрый старт
1. Инициировать платёж
Для маркетплейса передайте Shops: сумма каждого магазина в копейках и комиссия (Fee), которая удерживается из возмещения партнёра. Если Fee не указан, банк возьмёт комиссию из настроек регистрации.
2. Подтвердить двухстадийное списание
3. Отменить / вернуть платёж
4. Получить статус платежа
5. Привязать карту
6. Оплата по привязанной карте (рекуррент)
7. Обработка webhook
8. Список и удаление карт
9. Статус заказа (несколько платежей)
10. Закрывающий чек
11. FinishAuthorize (3DS, своя форма)
12. Тестовая среда
13. Списание по RebillId (Charge)
14. Оплата через СБП (GetQr)
15. Покупатели
16. Статус СБП-платежа (GetQrState)
17. Привязка счёта СБП (AddAccountQr)
В webhook-уведомлении типа QR доступны поля accountToken и requestKey:
18. Список банков СБП (GetQrBankList)
19. Автоплатёж СБП (ChargeQr)
20. Повторная отправка уведомлений (Resend)
21. Повтор при сетевых ошибках и переиспользование cURL
22. PSR-18 HTTP-клиент с retry
По умолчанию SDK использует cURL. Для интеграции с Guzzle или Symfony HttpClient:
Альтернатива — встроенный retry через конструктор TBankClient (работает с любым HttpClientContract):
PSR-18 без retry-обёртки:
Примеры (examples/)
В каталоге examples/ — готовые скрипты. Перед запуском задайте переменные окружения:
| Скрипт | Описание |
|---|---|
01-init-payment.php |
Одностадийный платёж с чеком |
02-two-step-payment.php |
Двухстадийный платёж (холд + Confirm) |
03-finish-authorize-3ds.php |
Завершение 3DS (MD + PaRes) |
04-webhook-endpoint.php |
Обработчик NotificationURL |
05-cards.php |
Привязка, список, удаление карт |
06-refund.php |
Полный и частичный возврат |
07-receipt.php |
Закрывающий чек |
08-check-status.php |
Статус платежа и заказа |
09-recurrent-payment.php |
Рекуррентный платёж |
10-charge.php |
Списание по RebillId |
11-sbp-payment.php |
Init + GetQr (СБП) |
12-customer.php |
Регистрация и получение покупателя |
13-sbp-qr-state.php |
Статус СБП-платежа |
14-sbp-bank-list.php |
Список банков СБП |
15-resend.php |
Повторная отправка уведомлений |
16-sbp-account-binding.php |
Привязка счёта + автоплатёж СБП |
17-marketplace-shops.php |
Init с Shops и комиссией маркетплейса |
Архитектура пакета
Соглашения об именовании: DTO — суффикс Dto, enum — Enum, интерфейсы — Contract.
Обработка ошибок
Запуск тестов
Ссылки
Лицензия
MIT © Oleg Polyakov
All versions of tbank-payments with dependencies
ext-curl Version *
ext-json Version *
ext-mbstring Version *
ext-uri Version *
psr/http-client Version ^1.0
psr/http-factory Version ^1.0