PHPackages                             mihaitatomir/omnipay-vivapayments - 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. mihaitatomir/omnipay-vivapayments

ActiveLibrary[Payment Processing](/categories/payments)

mihaitatomir/omnipay-vivapayments
=================================

Viva Payments (Greece) driver for the Omnipay payment processing library

02PHP

Since Feb 16Pushed 4y ago1 watchersCompare

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

READMEChangelogDependenciesVersions (1)Used By (0)

Omnipay: VivaPayments
=====================

[](#omnipay-vivapayments)

**VivaPayments driver for the Omnipay PHP payment processing library**

[![Build Status](https://camo.githubusercontent.com/05ab342488682ba56ed8df03b0dab8e4609f699d7fe80726f53cb0988b9d4ac4/68747470733a2f2f7472617669732d63692e6f72672f6d696861697461746f6d69722f6f6d6e697061792d766976617061796d656e74732e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/mihaitatomir/omnipay-vivapayments)[![StyleCI](https://camo.githubusercontent.com/137742abbae34217fcecfe0f9ee29c10dda94367c99da3738485be71866d128c/68747470733a2f2f7374796c6563692e696f2f7265706f732f39333733333233342f736869656c64)](https://styleci.io/repos/93733234)[![Latest Stable Version](https://camo.githubusercontent.com/b79e776820b7ccaf9b0dc501552bee7155e894f4e508cdcfb0ba9efc6d12cbfd/68747470733a2f2f706f7365722e707567782e6f72672f6d696861697461746f6d69722f6f6d6e697061792d766976617061796d656e74732f76657273696f6e2e706e67)](https://packagist.org/packages/mihaitatomir/omnipay-vivapayments)[![Total Downloads](https://camo.githubusercontent.com/1e145d4770d0f72ff6345538a076e483ce06ebf222149e2cd582610e5fa006e1/68747470733a2f2f706f7365722e707567782e6f72672f6d696861697461746f6d69722f6f6d6e697061792d766976617061796d656e74732f642f746f74616c2e706e67)](https://packagist.org/packages/mihaitatomir/omnipay-vivapayments)

[Omnipay](https://github.com/omnipay/omnipay) is a framework agnostic, multi-gateway payment processing library for PHP 5.3+. This package implements VivaPayments support for Omnipay.

[Viva Payments](https://www.vivawallet.com/en-us/company) is a licensed e-money institution for operations in the EEA-31 region by the Bank of Greece.

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

[](#installation)

Omnipay is installed via [Composer](http://getcomposer.org/). To install, simply add it to your `composer.json` file:

```
composer require mihaitatomir/omnipay-vivapayments

```

And run composer to update your dependencies:

```
$ curl -s http://getcomposer.org/installer | php
$ php composer.phar update

```

Basic Usage
-----------

[](#basic-usage)

The following gateways are provided by this package:

- VivaPayments\_Redirect
- VivaPayments\_Native
- VivaPayments\_VivaWallet (not yet implemented)

All of these gateways use similar principles (REST) with many of the methods being common between the three gateways. I have therefore used an abstract RestGateway class to hold the common methods but this is not intended to be instantiated separately.

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

Documentation
-------------

[](#documentation)

For all documentation, usage examples, etc, see the documentation in the class docblocks.

There is a copy of the documentation online here (not necessarily up to date):

### Quirks

[](#quirks)

- All payments are in Euros (EUR). No other currency is supported.
- Creating a purchase is a two step process. Firstly there needs to be an order created. Then, depending on the gateway (Redirect vs REST), either the customer is redirected to the gateway or further customer information is provided by a second REST call.
- Direct card payments are not supported. Either a JS plugin is required (Native gateway) which creates a card reference, or a redirect is required (Redirect gateway).
- It is impossible to tell from the gateway response whether the transaction requires a redirect or not. It's only possible to tell from the type of request made. So I have created separate gateway classes for the different types of purchase request (Native vs Redirect) which will return different types of response.
- When making a redirect payment, upon completion of the checkout form, the customer is redirected back to your website. The redirection URLs are defined in your vivapayments.com account under the Sources section. You cannot provide a per-transaction returnUrl or cancelUrl parameter to redirect each transaction to a different URL as can be done in some gateways.
- There is no separate void() method. The refund() method assumes a void() call is being made if it is within the same day as the transaction was created. In this case the refund amount must exactly equal the transaction amount.
- There is an authorize() transaction but there is no capture() transaction. Pre-authorized amounts stay on hold until they are cancelled or time out (up to 30 days).

Support
-------

[](#support)

If you are having general issues with Omnipay, we suggest posting on [Stack Overflow](http://stackoverflow.com/). Be sure to add the [omnipay tag](http://stackoverflow.com/questions/tagged/omnipay) so it can be easily found.

If you want to keep up to date with release anouncements, discuss ideas for the project, or ask more detailed questions, there is also a [mailing list](https://groups.google.com/forum/#!forum/omnipay) which you can subscribe to.

If you believe you have found a bug, please report it using the [GitHub issue tracker](https://github.com/mihaitatomir/omnipay-vivapayments/issues), or better yet, fork the library and submit a pull request.

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity2

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity27

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/1097f283d362185dcec9ddc385b6fc91958c988d1d98a97236aa2a12ce30c104?d=identicon)[mihaitatomir](/maintainers/mihaitatomir)

---

Top Contributors

[![mihaitatomir](https://avatars.githubusercontent.com/u/7744729?v=4)](https://github.com/mihaitatomir "mihaitatomir (8 commits)")

### Embed Badge

![Health badge](/badges/mihaitatomir-omnipay-vivapayments/health.svg)

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

###  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)
