PHPackages                             131/php-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. 131/php-sdk

ActiveLibrary[API Development](/categories/api)

131/php-sdk
===========

Bank131 PHP SDK

2.10.2(2mo ago)565.7k—8.4%6[1 issues](https://github.com/bank131/php-sdk/issues)MITPHPPHP ^7.3 || ^8.0

Since Jun 30Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/bank131/php-sdk)[ Packagist](https://packagist.org/packages/131/php-sdk)[ RSS](/packages/131-php-sdk/feed)WikiDiscussions master Synced 1mo ago

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

Bank131 SDK
===========

[](#bank131-sdk)

Библиотека для работы с API Bank131 в приложениях написанных на языке PHP.

Требования
----------

[](#требования)

- PHP 7.3 или выше

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

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

Рекомендуемый способ установки Bank 131 SDK - установка с помощью пакетного менеджера Composer.

Для включения данной библиотеки в ваш проект необходимо выполнить следующие команды в консоли:

```
cd /path/to/your/project
composer require 131/php-sdk
```

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

[](#документация)

Более подробные примеры в документации [API Банк 131](https://developer.131.ru)

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

[](#быстрый-старт)

### Инициализация клиента:

[](#инициализация-клиента)

```
use Bank131\SDK\Client;
use Bank131\SDK\Config;

$config = new Config(
    'https://demo.bank131.ru',
    'test_project',
    file_get_contents('/path/to/your/private_key.pem'),
    file_get_contents('/path/to/bank131/public_key.pem')
);
$client = new Client($config);
```

### Выпуск публичного токена для создания виджета:

[](#выпуск-публичного-токена-для-создания-виджета)

```
use Bank131\SDK\API\Request\Builder\RequestBuilderFactory;

$request = RequestBuilderFactory::create()
    ->issuePublicTokenBuilder()
    ->setTokenizeWidget()                   // публичный токен с доступом к виджету токенизации
    ->setSelfEmployedWidget('111111111111') // публичный токен с доступом к виджету для работы с самозанятыми
    ->setAcquiringWidget('session_id')      // публичный токен с доступом к виджету эквайринга
    ->build();

$response = $this->client->widget()->issuePublicToken($request);
```

### Создание и старт эквайринг сессии:

[](#создание-и-старт-эквайринг-сессии)

```
use Bank131\SDK\API\Request\Builder\RequestBuilderFactory;
use Bank131\SDK\Client;
use Bank131\SDK\DTO\Customer;
use Bank131\SDK\DTO\Card\BankCard;

$request = RequestBuilderFactory::create()
    ->createPaymentSession()
    ->build();

/** @var Client $client */
$createSessionResponse = $client->session()->create($request);

$request = RequestBuilderFactory::create()
    ->startPaymentSession($createSessionResponse->getSession()->getId())
    ->setCard(new BankCard('4242424242424242', '12', '22', '123', 'CARDHOLDER NAME'))
    ->setAmount(10000, 'rub')
    ->setCustomer(new Customer('reference'))
    ->setMetadata('your metadata here')
    ->build();

$sessionStartResponse = $this->client->session()->startPayment($request);
```

### Создание и старт сессии для осуществления выплаты:

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

```
use Bank131\SDK\API\Request\Builder\RequestBuilderFactory;
use Bank131\SDK\DTO\Card\EncryptedCard;
use Bank131\SDK\DTO\Customer;
use Bank131\SDK\DTO\Participant;
use Bank131\SDK\Client;

$request = RequestBuilderFactory::create()
    ->createPayoutSession()
    ->build();

/** @var Client $client */
$createSessionResponse = $client->session()->create($request);

$recipient = new Participant();
$recipient->setFullName('John Doe');

$request = RequestBuilderFactory::create()
    ->startPayoutSession($createSessionResponse->getSession()->getId())
    ->setCard(new EncryptedCard('number_hash_here'))
    ->setRecipient($recipient)
    ->setAmount(10000, 'rub')
    ->setCustomer(new Customer('reference'))
    ->setMetadata('your metadata here')
    ->build();

$sessionStartResponse = $this->client->session()->startPayout($request);
```

### Создание объекта выплатной сессии СБП

[](#создание-объекта-выплатной-сессии-сбп)

```
$request = RequestBuilderFactory::create()
    ->createPayoutSession()
    ->setBankAccount(
    new BankAccountFPS(
        '0070009210197',
        '100000000197',
        'Перевод средств по договору'
        )
    )
    ->build();
```

### Создание объекта платежной сессии через СБП

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

```
RequestBuilderFactory::create()
    ->createPaymentSession()
    ->makeFasterPaymentSystem()
    ->setAmount('3000', \Bank131\SDK\DTO\Enum\CurrencyEnum::RUB)
    ->build();
```

### Запрос статуса сессии:

[](#запрос-статуса-сессии)

```
use Bank131\SDK\Client;

/** @var Client $client */
$response = $this->client->session()->status('session_id');
```

### Возврат:

[](#возврат)

```
use Bank131\SDK\API\Request\Builder\RequestBuilderFactory;

$request = RequestBuilderFactory::create()
    ->refundSession('session_id')
    ->setAmount(1000, 'rub')
    ->setMetadata('your metadata here')
    ->build();

$response = $this->client->session()->refund($request);
```

### Запрос баланса кошелька:

[](#запрос-баланса-кошелька)

```
use Bank131\SDK\Client;

/** @var Client $client */
$response = $client->wallet()->balance();
```

### Обработка веб-хуков:

[](#обработка-веб-хуков)

```
use Bank131\SDK\Client;
use Bank131\SDK\Services\WebHook\Hook\WebHookTypeEnum;

/** @var Client $client */
$hook = $client->handleWebHook('sign from headers', 'request body');

switch ($hook->getType()) {
    case WebHookTypeEnum::READY_TO_CONFIRM:
        $client->session()->confirm($hook->getSession()->getId());
        break;
    case WebHookTypeEnum::READY_TO_CAPTURE:
        $client->session()->capture($hook->getSession()->getId());
        break;
    case WebHookTypeEnum::ACTION_REQUIRED:
        //do some logic
        break;
    case WebHookTypeEnum::PAYMENT_FINISHED:
        //do some logic
        break;
    case WebHookTypeEnum::PAYMENT_REFUNDED:
        //do some logic
        break;
}
```

###  Health Score

56

—

FairBetter than 98% of packages

Maintenance80

Actively maintained with recent releases

Popularity37

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity77

Established project with proven stability

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

Recently: every ~18 days

Total

73

Last Release

83d ago

Major Versions

0.34.0 → 2.0.02024-10-30

0.35.0 → 2.6.02025-04-03

PHP version history (2 changes)0.1.0PHP ^7.3

0.16.0PHP ^7.3 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/eea9ff21e3759c6b51f3f357cafc851e7ea63bc158312646d8920f134371db47?d=identicon)[voodooism](/maintainers/voodooism)

![](https://www.gravatar.com/avatar/d6e349a2b6e18495ddd98e76f3650fb11e7c1ab45747d26874e653cb050c4c2e?d=identicon)[bank131](/maintainers/bank131)

---

Top Contributors

[![Vborisova131](https://avatars.githubusercontent.com/u/168710887?v=4)](https://github.com/Vborisova131 "Vborisova131 (6 commits)")

---

Tags

apisdkpayment processingbank131131

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/131-php-sdk/health.svg)

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

###  Alternatives

[saloonphp/saloon

Build beautiful API integrations and SDKs with Saloon

2.4k9.6M468](/packages/saloonphp-saloon)[theodo-group/llphant

LLPhant is a library to help you build Generative AI applications.

1.5k311.5k5](/packages/theodo-group-llphant)[square/square

Use Square APIs to manage and run business including payment, customer, product, inventory, and employee management.

793.4M21](/packages/square-square)[bushlanov-dev/max-bot-api-client-php

Max Bot API Client library

281.6k](/packages/bushlanov-dev-max-bot-api-client-php)

PHPackages © 2026

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