margitin/omnipay-ubb

UBB Bank Bulgaria UPC gateway for Omnipay payment processing library

v1.0.1 2026-01-05 14:50 UTC

Requires

• php: ^8.0
• ext-json: *
• ext-openssl: *
• omnipay/common: ^3
• symfony/http-client: ^7.4

Requires (Dev)

• http-interop/http-factory-guzzle: ^1.2
• omnipay/tests: ^4

MIT

• Ivan Margitin
• Georgi Tsvetanov

• payment
• pay
• gateway
• merchant
• purchase
• omnipay
• raiffeisen

README

UBB Bank E-commerce gateway for Omnipay payment processing library

Omnipay is a framework agnostic, multi-gateway payment processing library for PHP. This package implements Raiffeisen Bank BG support for Omnipay.

Installation

Omnipay is installed via Composer. To install, simply require league/omnipay and margitin/omnipay-ubb with Composer:

composer require league/omnipay margitin/omnipay-ubb

Basic Usage

Purchase

$gateway = Omnipay::create('Raiffeisen');

$gateway->setMerchantId($config['merchantId'])
    ->setTerminalId($config['terminalId'])
    ->setPrivateKey($config['privateKey'])
    ->setCurrency($config['currency'])
    ->setTestMode($config['testMode'])
    ->setGatewayCertificate($config['production_gateway_certificate']);

$response = $gateway->purchase(
    [
        'TotalAmount' => 100,
        'OrderID' => 'OrderID',
    ]
)->send();

// Process response
if ($response->isSuccessful()) {
    // Payment was successful
    print_r($response);
} elseif ($response->isRedirect()) {
    // Redirect to offsite payment gateway
    $response->redirect();
} else {
    // Payment failed
    echo $response->getMessage();
}

Complete Purchase

$response = $gateway->completePurchase()->send();

print_r($response->getData());
print_r($response->isSuccessful());
print_r($response->getCode());
print_r($response->getTransactionReference());

Refund

$response = $gateway->refund([
    'TotalAmount' => 100,
    'RefundAmount' => 100,
    'OrderID' => 'OrderID',
    'Rrn' => 'Rrn',
    'ApprovalCode' => 'ApprovalCode',
])->send();

print_r($response->getData());
print_r($response->isSuccessful());
print_r($response->getCode());
print_r($response->getMessage());

Fetch Transaction

$response = $gateway->fetchTransaction([
    'TotalAmount' => 100,
    'OrderID' => 'OrderID',
    'PurchaseTime' => 'PurchaseTime',
])->send();

print_r($response->getData());
print_r($response->isSuccessful());
print_r($response->isReversal());
print_r($response->getCode());
print_r($response->getMessage());
print_r($response->getTransactionReference());

Accept Notification

$response = $gateway->acceptNotification()->send();

print_r($response->getData());
print_r($response->isSuccessful());
print_r($response->getCode());
print_r($response->getMessage());
print_r($response->getTransactionReference());
print_r($response->getTransactionStatus());
print_r($response->getBody());

Pay By Token

$response = $gateway->payByToken([
    'TotalAmount' => 100,
    'OrderID' => 'OrderID',
    'UPCToken' => 'UPCToken',
])->send();

print_r($response->getData());
print_r($response->isSuccessful());
print_r($response->getCode());
print_r($response->getMessage());
print_r($response->getTransactionReference());
print_r($response->getTransactionStatus());
print_r($response->getBody());