PHPackages                             tbanov/omnipay-epay - 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. [Payment Processing](/categories/payments)
4. /
5. tbanov/omnipay-epay

ActiveLibrary[Payment Processing](/categories/payments)

tbanov/omnipay-epay
===================

Epay Bg gateway for Omnipay payment processing library

027

Since May 22Pushed 2y ago1 watchersCompare

[ Source](https://github.com/tbanov/omnipay-epay)[ Packagist](https://packagist.org/packages/tbanov/omnipay-epay)[ RSS](/packages/tbanov-omnipay-epay/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Omnipay: Epay
=============

[](#omnipay-epay)

**ePay.bg driver for the Omnipay PHP payment processing library**

[Omnipay](https://github.com/thephpleague/omnipay) is a framework agnostic, multi-gateway payment processing library for PHP 5.3+. This package implements Epay, EasyPay, Bpay and more Bugarian online payment providers support for Omnipay.

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

[](#installation)

Omnipay is installed via [Composer](http://getcomposer.org/). To install, simply run:

```
composer require gentor/omnipay-epay

```

### The following gateways are provided by this package:

[](#the-following-gateways-are-provided-by-this-package)

- [Epay (Epay Chekcout)](https://www.epay.bg/v3main/front?lang=en)
- [EasyPay Payment Services](https://www.easypay.bg/site/en/)

For general usage instructions, please see the main [Omnipay](https://github.com/thephpleague/omnipay)repository.

Basic Usage
===========

[](#basic-usage)

### Purchase

[](#purchase)

```
use Omnipay\Omnipay;

$provider = Epay; # Or Easypay
$gateway = Omnipay::create($provider);
$gateway->setMin('Epay Merchant Id');
$gateway->setSignature('Epay Signature');

$response = $gateway->purchase(
    [
        'amount' => '10.00', // BGN
        'transactionId' => 'Unique ID in your system',
        'returnUrl' => 'your.site.com/return',
        'cancelUrl' => 'your.site.com/cancel',
    ]
)->send();

if ($response->isSuccessful()) {
    // only EasyPay get IDN
    echo($response->getRedirectData());
} elseif ($response->isRedirect()) {
    // redirect to epay payment gateway
    $response->redirect();
} else {
    // payment failed: display message to customer
    echo $response->getMessage();
}
```

### Webhook

[](#webhook)

- Listener for payment status

```
//Use only epay gateway
$gateway = Omnipay::create('Epay');
$gateway->setMin('Epay Merchant Id');
$gateway->setSignature('Epay Signature');

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

if ($response->isSuccessful()) {
    $status = $response->getTransactionStatus();
    // Response is required for epay gateway to stop sending data
    echo $response->getData()['notify_text'];
} else {
    // Response is required for epay gateway to stop sending data
    echo $response->getData()['notify_text'];
}
```

### [ePay.bg Documentation](https://www.epay.bg/v3main/front?p=mrcs_tech)

[](#epaybg-documentation)

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity22

Early-stage or recently created project

 Bus Factor2

2 contributors hold 50%+ of commits

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/82f296c3e1a68faf1581f58092b4a51ee3bb839e1a31d019975489ff30952c45?d=identicon)[tihoti](/maintainers/tihoti)

---

Top Contributors

[![vanssata](https://avatars.githubusercontent.com/u/1220804?v=4)](https://github.com/vanssata "vanssata (7 commits)")[![gentor](https://avatars.githubusercontent.com/u/2902504?v=4)](https://github.com/gentor "gentor (6 commits)")[![rokasra](https://avatars.githubusercontent.com/u/6988736?v=4)](https://github.com/rokasra "rokasra (3 commits)")[![CuCTeMeH](https://avatars.githubusercontent.com/u/3748675?v=4)](https://github.com/CuCTeMeH "CuCTeMeH (1 commits)")

### Embed Badge

![Health badge](/badges/tbanov-omnipay-epay/health.svg)

```
[![Health](https://phpackages.com/badges/tbanov-omnipay-epay/health.svg)](https://phpackages.com/packages/tbanov-omnipay-epay)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

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