PHPackages                             stdex/php-tochka-api-v2-sdk - 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. stdex/php-tochka-api-v2-sdk

ActiveLibrary[API Development](/categories/api)

stdex/php-tochka-api-v2-sdk
===========================

Tochka bank API v2 client for PHP

1.3.2(9mo ago)18.1k—0%2MITPHPPHP >=7.1CI failing

Since Jan 11Pushed 9mo agoCompare

[ Source](https://github.com/stdex/php-tochka-api-v2-sdk)[ Packagist](https://packagist.org/packages/stdex/php-tochka-api-v2-sdk)[ Docs](https://github.com/stdex/php-tochka-api-v2-sdk)[ RSS](/packages/stdex-php-tochka-api-v2-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (2)Versions (8)Used By (0)

Tochka API v2 client for PHP
============================

[](#tochka-api-v2-client-for-php)

PHP SDK для Точка банк API версия 2

[Устаревшая первая версия API](https://github.com/lee-to/php-tochka-api-sdk)

Installation
------------

[](#installation)

Tochka API client for PHP can be installed with [Composer](https://getcomposer.org/). Run this command:

```
composer require stdex/php-tochka-api-v2-sdk
```

Использование
-------------

[](#использование)

[Документация](https://enter.tochka.com/doc/v2/redoc#section/Pro-API)

### Импорт.

[](#импорт)

```
use TochkaApi\Client;
use TochkaApi\HttpAdapters\CurlHttpClient;
```

### Инициализация.

[](#инициализация)

- Создаем приложение в личном кабинете Точка банк в разделе "Интеграции" и прописываем доступы

```
$tochkaApi = new \TochkaApi\Client("client_id", "client_secret", "redirect_uri", new CurlHttpClient);
```

### OAuth2 авторизация.

[](#oauth2-авторизация)

- Подтверждаем права пользования для приложения. Метод вернет урл для прохождения авторизации
- Согласно документации code живет 2 минуты

```
// Урл для авторизации, после подтверждения вернет $_GET["code"] на redirect_uri
$authorizeUrl = $tochkaApi->authorize();
header("Location: {$authorizeUrl}");
exit( );

//После успешной авторизации и подтверждения прав Точка банк выполнит редирект на redirect_uri указанный в Вашем приложении
//c параметром code
// code обменяется на токен и установится в клиент
$accessToken = $client->token($_GET["code"]);
$tochkaApi->setAccessToken($accessToken);
//Access token живет 24 часа
//Refresh token живет 30 дней

//Проверка не устарел ли токен ($createdTimestamp - timestamp создания токена)
if($tochkaApi->isExpired($createdTimestamp)) {

}
```

### Обновления токена

[](#обновления-токена)

```
//Вернет объект AccessToken
$client->refreshToken(string $refresh_token);
```

### Разрешения

[](#разрешения)

-
- По умолчанию установлены все разрешения

```
//Изменить scopes
$tochkaApi->setScopes(string $scopes);
```

```
//Изменить permissions
$tochkaApi->setPermissions(array $permissions);
```

### Работа со счетами

[](#работа-со-счетами)

#### Метод получения списка доступных счетов

[](#метод-получения-списка-доступных-счетов)

- [https://enter.tochka.com/doc/v2/redoc#operation/get\_accounts\_list\_open\_banking\_\_apiVersion\_\_accounts\_get](https://enter.tochka.com/doc/v2/redoc#operation/get_accounts_list_open_banking__apiVersion__accounts_get)

```
$tochkaApi->account()->all()
```

#### Метод получения информации по конкретному счёту

[](#метод-получения-информации-по-конкретному-счёту)

- [https://enter.tochka.com/doc/v2/redoc#operation/get\_account\_info\_open\_banking\_\_apiVersion\_\_accounts\_\_accountId\_\_get](https://enter.tochka.com/doc/v2/redoc#operation/get_account_info_open_banking__apiVersion__accounts__accountId__get)

Параметры:

- $accountId - Уникальный и неизменный идентификатор счёта

```
$tochkaApi->account($accountId)->get()
```

#### Метод получения информации о балансе конкретного счета

[](#метод-получения-информации-о-балансе-конкретного-счета)

- [https://enter.tochka.com/doc/v2/redoc#operation/get\_balance\_info\_open\_banking\_\_apiVersion\_\_accounts\_\_accountId\_\_balances\_get](https://enter.tochka.com/doc/v2/redoc#operation/get_balance_info_open_banking__apiVersion__accounts__accountId__balances_get)

Параметры:

- $accountID - Идентификатор счета

```
$tochkaApi->account($accountID)->balances()
```

#### Метод получения конкретной выписки

[](#метод-получения-конкретной-выписки)

- [https://enter.tochka.com/doc/v2/redoc#operation/get\_statement\_open\_banking\_\_apiVersion\_\_accounts\_\_accountId\_\_statements\_\_statementId\_\_get](https://enter.tochka.com/doc/v2/redoc#operation/get_statement_open_banking__apiVersion__accounts__accountId__statements__statementId__get)

Параметры:

- $accountID - Идентификатор счета
- $statementId - Идентификатор выписки

```
$tochkaApi->account($accountID)->statement($statementId)
```

### Работа с балансами счетов

[](#работа-с-балансами-счетов)

#### Метод получения баланса по нескольким счетам

[](#метод-получения-баланса-по-нескольким-счетам)

- [https://enter.tochka.com/doc/v2/redoc#operation/get\_balances\_list\_open\_banking\_\_apiVersion\_\_balances\_get](https://enter.tochka.com/doc/v2/redoc#operation/get_balances_list_open_banking__apiVersion__balances_get)

```
$tochkaApi->balance()->all()
```

### Работа с выписками

[](#работа-с-выписками)

#### Метод получения списка доступных выписок

[](#метод-получения-списка-доступных-выписок)

- [https://enter.tochka.com/doc/v2/redoc#operation/get\_statements\_list\_open\_banking\_\_apiVersion\_\_statements\_get](https://enter.tochka.com/doc/v2/redoc#operation/get_statements_list_open_banking__apiVersion__statements_get)

```
$tochkaApi->statement()->all()
```

#### Метод создания выписки по конкретному счету

[](#метод-создания-выписки-по-конкретному-счету)

- [https://enter.tochka.com/doc/v2/redoc#operation/init\_statement\_open\_banking\_\_apiVersion\_\_statements\_post](https://enter.tochka.com/doc/v2/redoc#operation/init_statement_open_banking__apiVersion__statements_post)

Параметры:

- $data - Request Body согласно документации

```
$tochkaApi->statement()->create($data)
```

### Работа с картами

[](#работа-с-картами)

#### Метод получения списка карт

[](#метод-получения-списка-карт)

- [https://enter.tochka.com/doc/v2/redoc#operation/get\_cards\_card\_\_api\_version\_\_card\_get](https://enter.tochka.com/doc/v2/redoc#operation/get_cards_card__api_version__card_get)

Параметры:

- $cardCode - GUID карты в ПЦ Точки
- $customerCode - Уникальный код клиента

```
$tochkaApi->card($cardCode, $customerCode)->all()
```

#### Метод редактирования карты

[](#метод-редактирования-карты)

- [https://enter.tochka.com/doc/v2/redoc#operation/edit\_card\_card\_\_apiVersion\_\_card\_\_cardCode\_\_post](https://enter.tochka.com/doc/v2/redoc#operation/edit_card_card__apiVersion__card__cardCode__post)

Параметры:

- $cardCode - GUID карты в ПЦ Точки
- $customerCode - Уникальный код клиента
- $data - Request Body согласно документации

```
$tochkaApi->card($cardCode, $customerCode)->update($data)
```

#### Метод закрытия карты

[](#метод-закрытия-карты)

- [https://enter.tochka.com/doc/v2/redoc#operation/delete\_card\_card\_\_apiVersion\_\_card\_\_cardCode\_\_delete](https://enter.tochka.com/doc/v2/redoc#operation/delete_card_card__apiVersion__card__cardCode__delete)

Параметры:

- $cardCode - GUID карты в ПЦ Точки
- $customerCode - Уникальный код клиента

```
$tochkaApi->card($cardCode, $customerCode)->delete()
```

#### Показывает действующие лимиты по карте

[](#показывает-действующие-лимиты-по-карте)

- [https://enter.tochka.com/doc/v2/redoc#operation/get\_card\_limits\_card\_\_apiVersion\_\_card\_\_cardCode\_\_limits\_get](https://enter.tochka.com/doc/v2/redoc#operation/get_card_limits_card__apiVersion__card__cardCode__limits_get)

Параметры:

- $cardCode - GUID карты в ПЦ Точки
- $customerCode - Уникальный код клиента
- $query - Query parameters согласно документации

```
$tochkaApi->card($cardCode, $customerCode)->limits($query)
```

#### Метод смены состояния карты

[](#метод-смены-состояния-карты)

- [https://enter.tochka.com/doc/v2/redoc#operation/edit\_card\_state\_card\_\_apiVersion\_\_card\_\_cardCode\_\_state\_post](https://enter.tochka.com/doc/v2/redoc#operation/edit_card_state_card__apiVersion__card__cardCode__state_post)

Параметры:

- $cardCode - GUID карты в ПЦ Точки
- $customerCode - Уникальный код клиента
- $data - Request Body согласно документации

```
$tochkaApi->card($cardCode, $customerCode)->state($data)
```

### Работа с клиентами

[](#работа-с-клиентами)

#### Метод получения списка доступных клиентов

[](#метод-получения-списка-доступных-клиентов)

- [https://enter.tochka.com/doc/v2/redoc#operation/get\_customers\_list\_open\_banking\_\_apiVersion\_\_customers\_get](https://enter.tochka.com/doc/v2/redoc#operation/get_customers_list_open_banking__apiVersion__customers_get)

```
$tochkaApi->customer()->all()
```

#### Метод получения информации по конкретному клиенту

[](#метод-получения-информации-по-конкретному-клиенту)

- [https://enter.tochka.com/doc/v2/redoc#operation/get\_customer\_info\_open\_banking\_\_apiVersion\_\_customers\_\_customerCode\_\_get](https://enter.tochka.com/doc/v2/redoc#operation/get_customer_info_open_banking__apiVersion__customers__customerCode__get)

Параметры:

- $customerCode - Уникальный код клиента

```
$tochkaApi->customer($customerCode)->get()
```

### Работа с платежами

[](#работа-с-платежами)

#### Методы создания и подписания платежа

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

-
- [https://enter.tochka.com/doc/v2/redoc#operation/create\_payment\_for\_sign\_payment\_\_apiVersion\_\_for\_sign\_post](https://enter.tochka.com/doc/v2/redoc#operation/create_payment_for_sign_payment__apiVersion__for_sign_post)
- [https://enter.tochka.com/doc/v2/redoc#operation/create\_payment\_payment\_\_apiVersion\_\_order\_post](https://enter.tochka.com/doc/v2/redoc#operation/create_payment_payment__apiVersion__order_post)

Параметры:

- $data - Request Body согласно документации
- $forSign - С подписью либо без

```
$tochkaApi->payment()->create($data, $forSign = true)
```

- Метод создания и подписания платежа ($forSign = false) вернет ответ вида

```
    "Data": {
    "requestId": "openapi-b96d770e-769f-49ce-9630-890e00d47720",
    "redirectURL": "https://enter.tochka.com/payment/?requestId=openapi-b96d770e-769f-49ce-9630-890e00d47720&clientId=ВАШ_КЛИЕНТ_ID"
}
```

- где redirectURL - Ссылка на страницу для редиректа. В query-параметрах указываются поля платежа. Далее необходимо подписать платеж кодом

#### Метод получения статуса платежа

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

- [https://enter.tochka.com/doc/v2/redoc#operation/get\_payment\_status\_payment\_\_apiVersion\_\_status\_\_requestId\_\_get](https://enter.tochka.com/doc/v2/redoc#operation/get_payment_status_payment__apiVersion__status__requestId__get)

Параметры:

- $requestId - Идентификатор запроса (платежа)

```
$tochkaApi->payment($requestId)->get()
```

### Выполнение произвольного запроса к API (Пока методы СБП в разработке)

[](#выполнение-произвольного-запроса-к-api-пока-методы-сбп-в-разработке)

Параметры:

- $method - GET|POST|DELETE|UPDATE|PUT
- $url - Урл, например
- $data - Request Body

```
$tochkaApi->custom()->request($method, $url, $data = [])
```

- Если требуется customer-code в header

```
$tochkaApi->custom(null, $customerCode)->request($method, $url, $data = [])
```

Tests
-----

[](#tests)

1. [Composer](https://getcomposer.org/) is a prerequisite for running the tests. Install composer globally, then run `composer install` to install required files.
2. The tests can be executed by running this command from the root directory:

```
./vendor/bin/phpunit
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Credits
-------

[](#credits)

- [Danil Shutsky](https://github.com/lee-to)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

Security
--------

[](#security)

If you have found a security issue, please contact the maintainers directly at .

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance57

Moderate activity, may be stable

Popularity25

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 71.4% 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 ~201 days

Total

5

Last Release

286d ago

PHP version history (2 changes)1.1PHP ^7.1

1.2PHP >=7.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/1dcbb34b20f4b494c9fd00bb9be8d70b15fcd517c796853e75fa33a1784371d6?d=identicon)[stdex](/maintainers/stdex)

---

Top Contributors

[![stdex](https://avatars.githubusercontent.com/u/4608879?v=4)](https://github.com/stdex "stdex (10 commits)")[![lee-to](https://avatars.githubusercontent.com/u/1861327?v=4)](https://github.com/lee-to "lee-to (2 commits)")[![MansurovAlexander](https://avatars.githubusercontent.com/u/107881836?v=4)](https://github.com/MansurovAlexander "MansurovAlexander (2 commits)")

---

Tags

apiv2Tochka

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/stdex-php-tochka-api-v2-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/stdex-php-tochka-api-v2-sdk/health.svg)](https://phpackages.com/packages/stdex-php-tochka-api-v2-sdk)
```

###  Alternatives

[spatie/dropbox-api

A minimal implementation of Dropbox API v2

3116.0M36](/packages/spatie-dropbox-api)[gorkalaucirica/hipchat-v2-api-client

Hipchat v2 API client

80223.4k6](/packages/gorkalaucirica-hipchat-v2-api-client)[srmklive/flysystem-dropbox-v2

Flysystem Adapter for Dropbox API v2

20179.1k9](/packages/srmklive-flysystem-dropbox-v2)[m165437/laravel-blueprint-docs

API Blueprint Renderer for Laravel

22779.0k](/packages/m165437-laravel-blueprint-docs)[vinicinbgs/autentique-v2

Api Autentique V2

4336.8k](/packages/vinicinbgs-autentique-v2)[atomita/backlog-v2

this is backlog api v2 library

183.8k](/packages/atomita-backlog-v2)

PHPackages © 2026

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