PHPackages                             vs-point/rb-premium - 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. vs-point/rb-premium

ActiveLibrary[API Development](/categories/api)

vs-point/rb-premium
===================

A PHP library for communication with the Raiffeisenbank Premium API.

1.0.0(yesterday)00MITPHPPHP >=8.2

Since Apr 3Pushed yesterdayCompare

[ Source](https://github.com/vs-point/rb-premium)[ Packagist](https://packagist.org/packages/vs-point/rb-premium)[ RSS](/packages/vs-point-rb-premium/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (11)Versions (2)Used By (0)

vs-point/rb-premium
===================

[](#vs-pointrb-premium)

PHP knihovna pro komunikaci s [Raiffeisenbank Premium API](https://developers.rb.cz/premium/). Typovaný interface pro bankovní účty, transakce, platební dávky, výpisy a devizové kurzy.

Instalace
---------

[](#instalace)

```
composer require vs-point/rb-premium
```

Konfigurace
-----------

[](#konfigurace)

Autentizace probíhá přes **mTLS** (klientský certifikát) + hlavičku `X-IBM-Client-Id`.

### Převod PKCS#12 (.p12) na PEM

[](#převod-pkcs12-p12-na-pem)

Knihovna očekává certifikát ve formátu PEM. Pokud máš od banky soubor `.p12`, převeď ho pomocí `openssl`:

```
# Heslo zadáš interaktivně (bezpečnější pro produkci)
openssl pkcs12 -in cert.p12 -out cert.pem -nodes

# Heslo inline (vhodné pro CI/CD scripty)
openssl pkcs12 -in cert.p12 -out cert.pem -nodes -passin pass:HESLO
```

Přepínač `-nodes` znamená, že privátní klíč nebude v PEM zašifrovaný (no DES). Pro produkci lze klíč ponechat zašifrovaný — pak je `-nodes` vynechat a heslo předat přes `certPassword`:

```
# PEM s heslem na klíči
openssl pkcs12 -in cert.p12 -out cert.pem -passin pass:HESLO -passout pass:NOVE_HESLO
```

Certifikát a klíč lze také rozdělit do dvou souborů (parametry `certPath` + `keyPath`):

```
openssl pkcs12 -in cert.p12 -nokeys -out cert.pem -passin pass:HESLO
openssl pkcs12 -in cert.p12 -nocerts -nodes -out key.pem -passin pass:HESLO
```

```
use VsPoint\RBPremium\RBPremiumClient;
use VsPoint\RBPremium\RBPremiumConfig;
use VsPoint\RBPremium\Enum\Environment;

$config = new RBPremiumConfig(
    clientId: 'your-client-id',           // X-IBM-Client-Id
    certPath: '/path/to/cert.pem',        // PEM certifikát (může obsahovat i klíč)
    certPassword: null,                   // heslo certifikátu (pokud šifrovaný)
    keyPath: null,                        // PEM klíč zvlášť (pokud není v certPath)
    keyPassword: null,
    environment: Environment::Sandbox,    // nebo Environment::Production
);

$client = RBPremiumClient::create($config);
```

### Integrace se Symfony DI

[](#integrace-se-symfony-di)

```
# config/services.yaml
services:
    VsPoint\RBPremium\RBPremiumConfig:
        arguments:
            $clientId: '%env(RB_PREMIUM_CLIENT_ID)%'
            $certPath: '%env(RB_PREMIUM_CERT_PATH)%'
            $environment: !php/enum VsPoint\RBPremium\Enum\Environment::Production

    VsPoint\RBPremium\RBPremiumClient:
        factory: ['VsPoint\RBPremium\RBPremiumClient', 'create']
        arguments:
            $config: '@VsPoint\RBPremium\RBPremiumConfig'
```

Použití
-------

[](#použití)

### Bankovní účty

[](#bankovní-účty)

```
// Výpis účtů
$result = $client->accounts->list();

foreach ($result->accounts as $account) {
    echo $account->iban . ' — ' . $account->mainCurrency?->getCurrencyCode() . PHP_EOL;
}

// Stránkování
use VsPoint\RBPremium\DTO\Account\AccountQuery;

$result = $client->accounts->list(new AccountQuery(page: 1, size: 20));

// Zůstatky účtu
$balance = $client->accounts->balance('1234567890');

foreach ($balance->currencyFolders as $folder) {
    echo $folder->currency?->getCurrencyCode() . ':' . PHP_EOL;
    foreach ($folder->balances as $item) {
        echo '  ' . $item->balanceType?->value . ': ' . $item->toMoney() . PHP_EOL;
    }
}
```

### Transakce

[](#transakce)

```
use Brick\DateTime\LocalDate;
use Brick\Money\Currency;
use VsPoint\RBPremium\DTO\Transaction\TransactionQuery;

$result = $client->transactions->list(
    accountNumber: '1234567890',
    currency: Currency::of('CZK'),
    query: new TransactionQuery(
        from: LocalDate::of(2024, 1, 1),
        to: LocalDate::of(2024, 1, 31),
        page: 1,
    ),
);

foreach ($result->transactions as $tx) {
    $money = $tx->amount?->toMoney();
    echo $tx->bookingDate . ' ' . $money . ' ' . $tx->creditDebitIndication?->value . PHP_EOL;

    $ref = $tx->entryDetails?->transactionDetails?->remittanceInformation?->creditorReferenceInformation;
    if ($ref !== null) {
        echo '  VS: ' . $ref->variable . ', KS: ' . $ref->constant . PHP_EOL;
    }
}
```

### Platební dávky

[](#platební-dávky)

```
use VsPoint\RBPremium\Enum\BatchImportFormat;

// Import dávky
$fileContent = file_get_contents('/path/to/payments.xml');

$response = $client->payments->importBatch(
    fileContent: $fileContent,
    format: BatchImportFormat::SepaXml,
    batchName: 'Platby leden 2024',
    autocorrect: true,
);

echo 'Batch ID: ' . $response->batchFileId . PHP_EOL;

// Stav dávky
$batch = $client->payments->getBatch($response->batchFileId);
echo 'Stav: ' . $batch->batchFileStatus?->value . PHP_EOL;
```

### Výpisy

[](#výpisy)

```
use Brick\DateTime\LocalDate;
use VsPoint\RBPremium\DTO\Statement\StatementDownloadPayload;
use VsPoint\RBPremium\DTO\Statement\StatementListPayload;
use VsPoint\RBPremium\Enum\StatementFormat;
use VsPoint\RBPremium\Enum\StatementLine;

// Seznam výpisů
$result = $client->statements->list(new StatementListPayload(
    accountNumber: '1234567890',
    statementLine: StatementLine::Main,
    dateFrom: LocalDate::of(2024, 1, 1),
    dateTo: LocalDate::of(2024, 1, 31),
));

foreach ($result->statements as $statement) {
    echo $statement->statementId . ' (' . $statement->dateFrom . ' – ' . $statement->dateTo . ')' . PHP_EOL;
}

// Stažení výpisu jako PDF
$pdfContent = $client->statements->download(new StatementDownloadPayload(
    accountNumber: '1234567890',
    statementId: $result->statements[0]->statementId,
    statementFormat: StatementFormat::Pdf,
));

file_put_contents('/tmp/vypis.pdf', $pdfContent);
```

### Devizové kurzy

[](#devizové-kurzy)

```
use Brick\DateTime\LocalDate;
use Brick\Money\Currency;

// Aktuální kurzy
$result = $client->fxRates->list();

// Kurzy k datu
$result = $client->fxRates->list(LocalDate::of(2024, 1, 15));

// Kurz konkrétní měny
$result = $client->fxRates->get(Currency::of('EUR'));

foreach ($result->exchangeRateLists as $list) {
    foreach ($list->exchangeRates as $rate) {
        echo $rate->currencyFrom?->getCurrencyCode() . '/' . $rate->currencyTo?->getCurrencyCode()
            . ' nákup: ' . $rate->exchangeRateBuy
            . ' prodej: ' . $rate->exchangeRateSell
            . PHP_EOL;
    }
}
```

Přehled endpointů
-----------------

[](#přehled-endpointů)

ServiceMetodaEndpoint`accounts``list(?AccountQuery)`GET `/accounts``accounts``balance(accountNumber)`GET `/accounts/{accountNumber}/balance``transactions``list(accountNumber, Currency, TransactionQuery)`GET `/accounts/{accountNumber}/{currencyCode}/transactions``payments``importBatch(...)`POST `/payments/batches``payments``getBatch(batchFileId)`GET `/payments/batches/{batchFileId}``statements``list(StatementListPayload)`POST `/accounts/statements``statements``download(StatementDownloadPayload)`POST `/accounts/statements/download``fxRates``list(?LocalDate)`GET `/fxrates``fxRates``get(Currency, ?LocalDate)`GET `/fxrates/{currencyCode}`

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity45

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

Unknown

Total

1

Last Release

1d ago

### Community

Maintainers

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

---

Top Contributors

[![vitek499](https://avatars.githubusercontent.com/u/1543645?v=4)](https://github.com/vitek499 "vitek499 (3 commits)")

---

Tags

apiBankingpremiumraiffeisenbankrb

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleECS

Type Coverage Yes

### Embed Badge

![Health badge](/badges/vs-point-rb-premium/health.svg)

```
[![Health](https://phpackages.com/badges/vs-point-rb-premium/health.svg)](https://phpackages.com/packages/vs-point-rb-premium)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M625](/packages/sylius-sylius)[craftcms/cms

Craft CMS

3.6k3.6M2.4k](/packages/craftcms-cms)[googleads/googleads-php-lib

Google Ad Manager SOAP API Client Library for PHP

67410.3M25](/packages/googleads-googleads-php-lib)[api-platform/symfony

Symfony API Platform integration

323.2M64](/packages/api-platform-symfony)[api-platform/serializer

API Platform core Serializer

223.4M31](/packages/api-platform-serializer)[apigee/apigee-client-php

Client library for connecting to the Apigee Edge API.

27558.7k3](/packages/apigee-apigee-client-php)

PHPackages © 2026

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