PHPackages                             gamsh/php-tinkoff-payment - 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. [Payment Processing](/categories/payments)
4. /
5. gamsh/php-tinkoff-payment

ActiveLibrary[Payment Processing](/categories/payments)

gamsh/php-tinkoff-payment
=========================

Tinkoff payment client for PHP 8.3+

2.1.3(1y ago)0330↓50%MITPHPPHP >=8.3

Since Oct 22Pushed 1y ago1 watchersCompare

[ Source](https://github.com/GaMsh/php-tinkoff-payment)[ Packagist](https://packagist.org/packages/gamsh/php-tinkoff-payment)[ RSS](/packages/gamsh-php-tinkoff-payment/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (6)Used By (0)

Tinkoff Payment API client
==========================

[](#tinkoff-payment-api-client)

Клиент для проведения платежей [API Тинькофф Платежи](https://www.tinkoff.ru/kassa/develop/api/payments/).

Установка
---------

[](#установка)

```
composer require gamsh/php-tinkoff-payment
```

Реализованные API
-----------------

[](#реализованные-api)

#### Платежи

[](#платежи)

- [Создание платежа](https://www.tinkoff.ru/kassa/develop/api/payments/init-description/)
- [Отмена платежа](https://www.tinkoff.ru/kassa/develop/api/payments/cancel-description/)
- [Получение статуса платежа](https://www.tinkoff.ru/kassa/develop/api/payments/getstate-description/)
- [Получения статуса заказа](https://www.tinkoff.ru/kassa/develop/api/payments/checkorder-description/)
- [Повторить неуспешные нотификации](https://www.tinkoff.ru/kassa/develop/api/payments/resend-description/)
- [Подтверждение платежа](https://www.tinkoff.ru/kassa/develop/api/payments/confirm-description/)

#### Автоплатежи

[](#автоплатежи)

- [Автоплатеж](https://www.tinkoff.ru/kassa/develop/api/autopayments/charge-description/)

Примеры
-------

[](#примеры)

### Создание клиента

[](#создание-клиента)

```
/** @var PaymentClientInterface $paymentClient */
$paymentClient = PaymentClient::create('', '');
```

### Создание платежа

[](#создание-платежа)

[API создания платежа](https://www.tinkoff.ru/kassa/develop/api/payments/init-description/)

[Полный пример](examples/init.php)

```
$payment = newPayment()
    ->amount(1000)
    ->orderId('1234')
    ->oneStep()
->build();

/** @var NewPaymentResultInterface $result */
$result = $paymentClient->init($payment);

if ($result->isSuccess()) {
    print 'PaymentId: ' . $result->getPaymentId() . "\n";
    print 'PaymentURL: ' . $result->getPaymentURL() . "\n";
} else {
    print 'Error: ' . $result->getMessage() . "\n";
}
```

### Создание платежа с чеком

[](#создание-платежа-с-чеком)

[Полный пример](examples/init.php)

```
$payment = newPayment()
    ->orderId('33101')
    ->oneStep()
    ->receipt(newReceipt()
        ->email('fake@fake.org')
        ->taxationOSN()
        ->addItem(newReceiptItem()
            ->name('Кружка')
            ->price(1000)
            ->quantity(1)
            ->taxNone()
            ->build())
        ->build())
    ->build();

/** @var NewPaymentResultInterface $result */
$result = $paymentClient->init($payment);

if ($result->isSuccess()) {
    print 'PaymentId: ' . $result->getPaymentId() . "\n";
    print 'PaymentURL: ' . $result->getPaymentURL() . "\n";
} else {
    print 'Error: ' . $result->getMessage() . "\n";
}
```

### Отмена платежа

[](#отмена-платежа)

[API отмена платежа](https://www.tinkoff.ru/kassa/develop/api/payments/cancel-description/)

[Полный пример](examples/cancel.php)

```
/** @var CancelResultInterface $result */
$result = $paymentClient->cancel(1647427416);

if ($result->isSuccess()) {
    print 'PaymentId: ' . $result->getPaymentId() . ' [' . $result->getStatus() . "]\n";
} else {
    print 'Error: ' . $result->getMessage() . "\n";
}
```

### Получение текущего статуса платежа

[](#получение-текущего-статуса-платежа)

[API получение текущего статуса платежа](https://www.tinkoff.ru/kassa/develop/api/payments/getstate-description/)

[Полный пример](examples/get_state.php)

```
/** @var GetStateResultInterface $result */
$result = $paymentClient->getState(1645861116);

if ($result->isSuccess()) {
    print 'PaymentId: ' . $result->getPaymentId() . ' [' . $result->getStatus() . "]\n";
} else {
    print 'Error: ' . $result->getMessage() . "\n";
}
```

### Получение статуса заказа

[](#получение-статуса-заказа)

[API получение статуса заказа](https://www.tinkoff.ru/kassa/develop/api/payments/checkorder-description/)

[Полный пример](examples/check_order.php)

```
/** @var CheckOrderResultInterface $result */
$result = $paymentClient->checkOrder('34532135669');

if ($result->isSuccess()) {
    print 'OrderID: ' . $result->getOrderId() . "\n";
    print '-----' . "\n";
    foreach ($result->getPayments() as $payment) {
        print 'PaymentID: ' . $payment->getPaymentId() . "\n";
        print 'Status: ' . $payment->getStatus() . "\n";
        print 'Success: ' . $payment->getSuccess() . "\n";
        print 'RRN: ' . $payment->getRRN() . "\n";
        print '=====' . "\n";
    }
} else {
    print 'Error: ' . $result->getMessage() . "\n";
}
```

### Повторить неуспешные нотификации

[](#повторить-неуспешные-нотификации)

[API повторной отправки неуспешных нотификаций](https://www.tinkoff.ru/kassa/develop/api/payments/resend-description/)

[Полный пример](examples/resend.php)

```
/** @var ResendResultInterface $result */
$result = $paymentClient->resendNotifications();

if ($result->isSuccess()) {
    print 'Count: ' . $result->getCount() . "\n";
} else {
    print 'Error: ' . $result->getMessage() . "\n";
}
```

### Автоплатежи

[](#автоплатежи-1)

#### Родительский платеж

[](#родительский-платеж)

Вызовите метод Init с параметрами Recurrent и CustomerKey Переадресуйте покупателя на страницу оплаты и дождитесь совершения платежа В нотификации AUTHORIZED или CONFIRMED получите и сохраните идентификатор RebillID

[API проведения автоплатежа](https://www.tinkoff.ru/kassa/develop/api/autopayments/charge-description/)

```
$charge = new Charge();
$charge->setPaymentId(10942);
$charge->setRebillId(4567);
$result = $paymentClient->charge($charge);

if ($result->isSuccess()) {
    // Успех
} else {
    // Ошибка
}
```

Запуск тестов
-------------

[](#запуск-тестов)

```
composer test
```

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

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 ~0 days

Total

5

Last Release

573d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8fdc58d746e3b808e2b254095495b566cd620e1b748522296ec55cfcd455bb0f?d=identicon)[GaMsh](/maintainers/GaMsh)

---

Top Contributors

[![moshkov-konstantin](https://avatars.githubusercontent.com/u/184231119?v=4)](https://github.com/moshkov-konstantin "moshkov-konstantin (8 commits)")

---

Tags

paymentpaykassatinkoff

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/gamsh-php-tinkoff-payment/health.svg)

```
[![Health](https://phpackages.com/badges/gamsh-php-tinkoff-payment/health.svg)](https://phpackages.com/packages/gamsh-php-tinkoff-payment)
```

###  Alternatives

[lokielse/omnipay-alipay

Alipay gateway for Omnipay payment processing library

587421.0k11](/packages/lokielse-omnipay-alipay)[paveldanilin/php-tinkoff-payment

Tinkoff payment client for PHP 7.4+

104.2k](/packages/paveldanilin-php-tinkoff-payment)[sudiptpa/omnipay-nabtransact

National Australia Bank (NAB) Transact driver for the Omnipay payment processing library.

1017.2k](/packages/sudiptpa-omnipay-nabtransact)[lucassmacedo/omnipay-mercadopago

MercadoPago gateway for OmniPay

154.6k](/packages/lucassmacedo-omnipay-mercadopago)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)