README

• Victoriabank IPS Business WebApi docs: https://test-ipspj.victoriabank.md
• Victoriabank IPS DemoPay WebApi https://test-ipspj-demopay.victoriabank.md/swagger/
• GitHub project https://github.com/alexminza/victoriabank-mia-sdk-php
• Composer package https://packagist.org/packages/alexminza/victoriabank-mia-sdk

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

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

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

$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

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

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

Perform a test QR payment

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

Get QR status

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

Refund payment

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