PHPackages                             alexminza/victoriabank-mia-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. alexminza/victoriabank-mia-sdk

ActiveLibrary[API Development](/categories/api)

alexminza/victoriabank-mia-sdk
==============================

PHP SDK for Victoriabank MIA API

v1.0.4(3mo ago)126[1 PRs](https://github.com/alexminza/victoriabank-mia-sdk-php/pulls)1GPL-3.0-or-laterPHPPHP >=7.2.5

Since Oct 24Pushed 2mo agoCompare

[ Source](https://github.com/alexminza/victoriabank-mia-sdk-php)[ Packagist](https://packagist.org/packages/alexminza/victoriabank-mia-sdk)[ Docs](https://github.com/alexminza/victoriabank-mia-sdk-php)[ RSS](/packages/alexminza-victoriabank-mia-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (9)Versions (7)Used By (1)

PHP SDK for Victoriabank MIA API
================================

[](#php-sdk-for-victoriabank-mia-api)

[![Victoriabank MIA](https://repository-images.githubusercontent.com/1072137871/2b121be2-e5b1-40d9-a170-0c42295c615e)](https://repository-images.githubusercontent.com/1072137871/2b121be2-e5b1-40d9-a170-0c42295c615e)

- Victoriabank IPS Business WebApi docs:
- Victoriabank IPS DemoPay WebApi
- GitHub project
- Composer package

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

[](#installation)

To easily install or upgrade to the latest release, use `composer`:

```
composer require alexminza/victoriabank-mia-sdk
```

To enable logging add the `monolog` package:

```
composer require monolog/monolog
```

Getting started
---------------

[](#getting-started)

Import SDK:

```
require_once __DIR__ . '/vendor/autoload.php';

use Victoriabank\VictoriabankMia\VictoriabankMiaClient;
```

Add project configuration:

```
$DEBUG = getenv('DEBUG');

$VB_MIA_BASE_URI = getenv('VB_MIA_BASE_URI') ?: VictoriabankMiaClient::TEST_BASE_URL;
$VB_MIA_USERNAME = getenv('VB_MIA_USERNAME');
$VB_MIA_PASSWORD = getenv('VB_MIA_PASSWORD');
$VB_CERTIFICATE  = getenv('VB_CERTIFICATE') ?: 'file://VBCA.crt';
$VB_COMPANY_NAME = getenv('VB_COMPANY_NAME');
$VB_COMPANY_IBAN = getenv('VB_COMPANY_IBAN');
```

Initialize client:

```
$options = [
    'base_uri' => $VB_MIA_BASE_URI,
    'timeout' => 30
];

if ($DEBUG) {
    $logName = 'victoriabank_mia_guzzle';
    $logFileName = "$logName.log";

    $log = new \Monolog\Logger($logName);
    $log->pushHandler(new \Monolog\Handler\StreamHandler($logFileName, \Monolog\Logger::DEBUG));

    $stack = \GuzzleHttp\HandlerStack::create();
    $stack->push(\GuzzleHttp\Middleware::log($log, new \GuzzleHttp\MessageFormatter(\GuzzleHttp\MessageFormatter::DEBUG)));

    $options['handler'] = $stack;
}

$guzzleClient = new \GuzzleHttp\Client($options);
$vbMiaClient = new VictoriabankMiaClient($guzzleClient);
```

SDK usage examples
------------------

[](#sdk-usage-examples)

### Get Access Token with username and password

[](#get-access-token-with-username-and-password)

```
$tokenResponse = $vbMiaClient->getToken('password', $VB_MIA_USERNAME, $VB_MIA_PASSWORD);
$accessToken = $tokenResponse['accessToken'];
```

### Create a dynamic order payment QR

[](#create-a-dynamic-order-payment-qr)

```
$qrData = [
    'header' => [
        'qrType' => 'DYNM', # Type of QR code: DYNM - Dynamic QR, STAT - Static QR, HYBR - Hybrid QR
        'amountType' => 'Fixed', # Specifies the type of amount: Fixed - Dynamic QR, Controlled - Static QR, Free - Hybrid QR
        'pmtContext' => 'e' #Payment context: m - mobile payment, e - e-commerce payment, i - invoice payment, 0 - other
    ],
    'extension' => [
        'creditorAccount' => [
            'iban' => $VB_COMPANY_IBAN
        ],
        'amount' => [
            'sum' => 123.45,
            'currency' => 'MDL'
        ],
        'dba' => $VB_COMPANY_NAME,
        'remittanceInfo4Payer' => 'Order #123',
        'creditorRef' => '123',
        'ttl' => [
            'length' => 60, #The duration for which the QR code is valid.
            'units' => 'mm' #The unit of time for the TTL: ss - seconds, mm - minutes
        ]
    ]
];

$createQrResponse = $vbMiaClient->createPayeeQr($qrData, $accessToken);
```

### Decode callback and validate signature

[](#decode-callback-and-validate-signature)

```
$callbackBody = 'eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzaWduYWxDb2RlIjoiRXhwaXJhdGlvbiIsInNpZ25hbER0VG0iOiIyMDI0LTEwLTAxVDE1OjA3OjQ1KzAzOjAwIiwicXJIZWFkZXJVVUlEIjoiYmQxMjA0OWItNjUxZC00MGEwLWIyYmMtZDZhMGY3ZTJiN2M3IiwicXJFeHRlbnNpb25VVUlEIjoiNjU0YWNkNjktNjAyYy00MzUxLTk1OTItODE0M2FlMjhkM2U0IiwicGF5bWVudCI6bnVsbH0.WJ5t8jtg2_6DPrxQNIcu50gsW7cDC8IMdjvOBO9wW3toIdeAljlMPxd_lLCWJiKXToRAVHU7a1EB4mLyzyw1iCcRadnsSqm21TrpDZWTjv3uL-XiMLrWOsGBf0aJJRFcGbysU_ym9YLonQMmYLF0voq39yAPMHO7CLCniSMhVdJ9Q5xnrq52y6Yn5YzefCNb2tAQ-erm-8_mCaF0DWd0UFhPA6TRXyV2l5GCkLbyhlUB9gVoVTdSN-XxA_1aoNTusheZPDH1InL03Bx3G8muaVxOMrMIsVCJJYAaTFKiQTBf0M49oTQpdPWeeS9wHaS7aSS3gUcFsOOEPavj7J8vxg';

$callbackData = VictoriabankMiaClient::decodeValidateCallback($callbackBody, $VB_CERTIFICATE);
```

### Perform a test QR payment

[](#perform-a-test-qr-payment)

```
$qrHeaderUUID = $createQrResponse['qrHeaderUUID'];
$demoPayResponse = $vbMiaClient->demoPay($qrHeaderUUID, $accessToken);
```

### Get QR status

[](#get-qr-status)

```
$getPayeeQrStatusResponse = $vbMiaClient->getPayeeQrStatus($qrHeaderUUID, $accessToken);
```

### Refund payment

[](#refund-payment)

```
$paymentTransactionId = VictoriabankMiaClient::getPaymentTransactionId($callbackData->payment->reference);
$vbMiaClient->reverseTransaction($paymentTransactionId, $accessToken);
```

###  Health Score

35

—

LowBetter than 79% of packages

Maintenance84

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

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

Total

6

Last Release

70d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8621365c2c0997e317ce43bf4211caf5ca443d487052f5e4e024ca4d297ac6ba?d=identicon)[alexminza](/maintainers/alexminza)

---

Top Contributors

[![alexminza](https://avatars.githubusercontent.com/u/149919?v=4)](https://github.com/alexminza "alexminza (28 commits)")

---

Tags

apimiamoldovapayment-gatewaypayment-integrationpaymentsphpqrsdkvictoriabankqrapisdkpaymentsMoldovavictoriabankmia

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/alexminza-victoriabank-mia-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/alexminza-victoriabank-mia-sdk/health.svg)](https://phpackages.com/packages/alexminza-victoriabank-mia-sdk)
```

###  Alternatives

[transbank/transbank-sdk

Transbank SDK

62626.4k12](/packages/transbank-transbank-sdk)[invoiced/invoiced

Invoiced PHP Library

14117.1k](/packages/invoiced-invoiced)

PHPackages © 2026

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