PHPackages justcommunication-ru/tinkoff-acquiring-api-client - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. justcommunication-ru/tinkoff-acquiring-api-client ActiveLibrary[API Development](/categories/api) justcommunication-ru/tinkoff-acquiring-api-client ================================================= Tinkoff Acquiring API PHP Client v1.0.5(8mo ago)102.5k6MITPHP Since Aug 13Pushed 8mo ago3 watchersCompare [ Source](https://github.com/JustCommunication-ru/tinkoff-acquiring-api-client)[ Packagist](https://packagist.org/packages/justcommunication-ru/tinkoff-acquiring-api-client)[ RSS](/packages/justcommunication-ru-tinkoff-acquiring-api-client/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (3)Versions (7)Used By (0) Tinkoff Acquiring API PHP Client ================================ [](#tinkoff-acquiring-api-php-client) [![Latest Stable Version](https://camo.githubusercontent.com/6ce2427a90ede345ca1f348eb465891f8b90db380b58b9af9a09d1e588cd262a/68747470733a2f2f706f7365722e707567782e6f72672f6a757374636f6d6d756e69636174696f6e2d72752f74696e6b6f66662d616371756972696e672d6170692d636c69656e742f76)](//packagist.org/packages/justcommunication-ru/tinkoff-acquiring-api-client)[![Latest Unstable Version](https://camo.githubusercontent.com/f12d853a3a723982994ffb1f08abbb85a8987053a06d7978c9469d3303653990/687474703a2f2f706f7365722e707567782e6f72672f6a757374636f6d6d756e69636174696f6e2d72752f74696e6b6f66662d616371756972696e672d6170692d636c69656e742f762f756e737461626c65)](https://packagist.org/packages/justcommunication-ru/tinkoff-acquiring-api-client)[![Total Downloads](https://camo.githubusercontent.com/fad654ca9372de160e3e74a0828f7505cc61413711bdf71931f704b536ac0c54/68747470733a2f2f706f7365722e707567782e6f72672f6a757374636f6d6d756e69636174696f6e2d72752f74696e6b6f66662d616371756972696e672d6170692d636c69656e742f646f776e6c6f616473)](//packagist.org/packages/justcommunication-ru/tinkoff-acquiring-api-client)[![License](https://camo.githubusercontent.com/5916cd75cfcf9d300fff2b6d0fff9ba890dcdf1c8f6b5426460e1c13e5496fcf/687474703a2f2f706f7365722e707567782e6f72672f6a757374636f6d6d756e69636174696f6e2d72752f74696e6b6f66662d616371756972696e672d6170692d636c69656e742f6c6963656e7365)](https://packagist.org/packages/justcommunication-ru/tinkoff-acquiring-api-client) PHP Клиент для интернет-эквайринга от Tinkoff Установка --------- [](#установка) `composer require justcommunication-ru/tinkoff-acquiring-api-client` Использование ------------- [](#использование) ``` use JustCommunication\TinkoffAcquiringAPIClient\TinkoffAcquiringAPIClient; $client = new TinkoffAcquiringAPIClient('', ''); ``` `` — Идентификатор терминала. Выдается продавцу банком при заведении терминала `` — ключ для подписи запросов Далее вызываются доступные методы: [Init](#Init) – создание платежа [GetState](#GetState) – текущий статус платежа [Confirm](#Confirm) – подтверждение платежа [Cancel](#Cancel) – отмена платежа Методы ------ [](#методы) ### Init [](#init) Метод создает платеж: продавец получает ссылку на платежную форму и должен перенаправить по ней покупателя ``` use JustCommunication\TinkoffAcquiringAPIClient\API\InitRequest; use JustCommunication\TinkoffAcquiringAPIClient\Exception\TinkoffAPIException; // Запрос на создание платежа на 100 рублей и внутренним номером `order-1234` $initRequest = new InitRequest(10000, 'order-1234'); // необязательные параметры $initRequest ->setLanguage($initRequest::LANGUAGE_EN) ->setIP('192.168.1.1') ->setDescription('Описание транзакции') ->setRecurrent('2') ->setCustomerKey('3') ->setNotificationURL('https://domain.tld/_api/notifications/124') ->setSuccessURL('https://domain.tld/_api/success/124') ->setFailURL('https://domain.tld/_api/fail/124') ->setPayType($request::PAY_TYPE_ONE_STAGE) ->setData([ 'Foo' => 'bar' ]) ; $initRequest->addData('Bar', 'baz'); try { $response = $client->sendInitRequest($initRequest); //$response->getPaymentId() // идентификатор платежа header('Location: ' . $response->getPaymentURL()); // перенаправляем пользователя на страницу оплаты exit; } catch (TinkoffAPIException $e) { // обработка ошибки } ``` ### GetState [](#getstate) Метод возвращает текущий статус платежа. ``` use JustCommunication\TinkoffAcquiringAPIClient\API\GetStateRequest; use JustCommunication\TinkoffAcquiringAPIClient\Exception\TinkoffAPIException; use JustCommunication\TinkoffAcquiringAPIClient\Model\Payment; $payment_id = '1234'; //Идентификатор платежа в системе банка $request = new GetStateRequest($payment_id); try { $response = $client->sendGetStateRequest($request); switch ($response->getStatus()) { case Payment::STATUS_CONFIRMED: break; case Payment::STATUS_CANCELED: // платеж был отменен break; } } catch (TinkoffAPIException $e) { // обработка ошибки } ``` ### Confirm [](#confirm) Метод подтверждает платеж и списывает ранее заблокированные средства. ``` use JustCommunication\TinkoffAcquiringAPIClient\API\ConfirmRequest; use JustCommunication\TinkoffAcquiringAPIClient\Exception\TinkoffAPIException; $payment_id = '1234'; //Идентификатор платежа в системе банка $request = new ConfirmRequest($payment_id); try { $response = $client->sendConfirmRequest($request); } catch (TinkoffAPIException $e) { // обработка ошибки } ``` ### Cancel [](#cancel) Метод отменяет платеж. ``` use JustCommunication\TinkoffAcquiringAPIClient\API\CancelRequest; use JustCommunication\TinkoffAcquiringAPIClient\Exception\TinkoffAPIException; $payment_id = '1234'; //Идентификатор платежа в системе банка $request = new CancelRequest($payment_id); try { $response = $client->sendCancelRequest($request); } catch (TinkoffAPIException $e) { // обработка ошибки } ``` Настройка HTTP клиента ---------------------- [](#настройка-http-клиента) ### Способ №1: передача массива параметров [](#способ-1-передача-массива-параметров) ``` use JustCommunication\TinkoffAcquiringAPIClient\TinkoffAcquiringAPIClient; $client = new TinkoffAcquiringAPIClient('token', 'secret', [ 'proxy' => 'tcp://localhost:8125', 'timeout' => 6, 'connect_timeout' => 4 ]); ``` Список доступных параметров: ### Способ №2: передача своего `\GuzzleHttp\Client` [](#способ-2-передача-своего-guzzlehttpclient) Настройте своего http клиента: ``` // Http клиент с логгированием всех запросов $stack = HandlerStack::create(); $stack->push(Middleware::log($logger, new MessageFormatter(MessageFormatter::DEBUG))); $httpClient = new \GuzzleHttp\Client([ 'handler' => $stack, 'timeout' => 6 ]); ``` и передайте его аргументом конструктора: ``` use JustCommunication\TinkoffAcquiringAPIClient\TinkoffAcquiringAPIClient; $client = new TinkoffAcquiringAPIClient('token', 'secret', $httpClient); ``` либо сеттером: ``` use JustCommunication\TinkoffAcquiringAPIClient\TinkoffAcquiringAPIClient; $client = new TinkoffAcquiringAPIClient('token', 'secret'); $client->setHttpClient($httpClient); ``` Логирование ----------- [](#логирование) В `$client` можно передать свой `Psr\Logger`. ``` $client->setLogger($someLogger); ``` По-умолчанию логирование отключено Тесты ----- [](#тесты) Запустить тесты можно командой: `vendor/bin/phpunit` ### Health Score 42 — FairBetter than 90% of packages Maintenance61 Regular maintenance activity Popularity30 Limited adoption so far Community11 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~296 days Recently: every ~358 days Total 6 Last Release 250d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/2c85524bc58444ab554ec47663bd1716ef1db841d7e245a4569f67c7da8e2d0c?d=identicon)[wiistriker](/maintainers/wiistriker) --- Top Contributors [![wiistriker](https://avatars.githubusercontent.com/u/967817?v=4)](https://github.com/wiistriker "wiistriker (9 commits)") --- Tags apisdkacquiringtinkoff ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/justcommunication-ru-tinkoff-acquiring-api-client/health.svg) ``` [![Health](https://phpackages.com/badges/justcommunication-ru-tinkoff-acquiring-api-client/health.svg)](https://phpackages.com/packages/justcommunication-ru-tinkoff-acquiring-api-client) ``` ### Alternatives [theodo-group/llphant LLPhant is a library to help you build Generative AI applications. 1.5k311.5k5](/packages/theodo-group-llphant)[mailchimp/transactional 458.9M16](/packages/mailchimp-transactional)[resend/resend-php Resend PHP library. 564.7M21](/packages/resend-resend-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)