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

ActiveLibrary[Payment Processing](/categories/payments)

kovena/omnipay-kovena
=====================

Kovena driver for Omnipay payment processing library

1.0.1(1y ago)0461MITPHP

Since Mar 20Pushed 1y ago2 watchersCompare

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

READMEChangelogDependencies (2)Versions (3)Used By (0)

Omnipay: Kovena
===============

[](#omnipay-kovena)

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

[](#installation)

Omnipay is installed via [Composer](http://getcomposer.org/). To install, simply require `league/omnipay` and `omnipay/kovena` with Composer:

```
composer require league/omnipay:^3 kovena/omnipay-kovena

```

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

[](#basic-usage)

The following gateways are provided by this package:

- [Kovena Payment Solutions](https://kovena.com/docs/api/)

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

### Kovena Connect

[](#kovena-connect)

Kovena is an embedded payment gateway service which replaces a traditional merchant facility. Accept Visa, Mastercard and Amex while managing fraud with free and customisable 3DS tools. Simplify you guest's payment experience today with Kovena.

Enjoy this incredible payment integration with no lock-in contracts or sign-up fees.

Register to place your hotel on our top priority list during our fast-approaching launch.

```
* No extra subscription fees
* Only pay per successful transaction
* No refund fees, in fact, you receive the original fee back!

```

Read more on Kovena Payment Solution [here](https://kovena.com/).

Examples
--------

[](#examples)

### Initialize Gateway

[](#initialize-gateway)

```
use Omnipay\Omnipay;

// Create a gateway for the Kovena Gateway
$gateway = Omnipay::create('Kovena');

// Initialize the gateway
$gateway->initialize([
    'apiKey' => 'your-api-key',
    'merchantId' => 'your-merchant-id',
    'testMode' => true
]);
```

### Authorize a Payment

[](#authorize-a-payment)

```
$response = $gateway->authorize([
    'amount' => '10.00',
    'currency' => 'AUD',
    'cardReference' => 'vault-token',
    'reference' => 'merchant_ref_001',
    'description' => 'Make purchase',
    'booking_info' => [
        'booking_date' => "2025-03-18",
        'booking_ref' => 'merchant_booking_ref_001',
        'check_in_date' => '2025-03-20',
        'check_out_date' => '2025-03-21',
        'customer_name' => 'Customer Name',
        'customer_email' => 'customer@example.com',
        'customer_phone' => '1234567890',
        'customer_country' => 'US',
        'surcharge_amount' => '0',
        'original_transaction_amount' => '10.00',
        'original_transaction_currency' => 'AUD',
    ]
])->send();

if ($response->isSuccessful()) {
    echo "Charge Reference: " . $response->getChargeReference() . "\n";
    echo "Transaction Reference: " . $response->getTransactionReference() . "\n";
}
```

### Capture an Authorized Payment

[](#capture-an-authorized-payment)

```
$response = $gateway->capture([
    'amount' => '10.00',
    'chargeReference' => 'charge-reference-from-authorize',
    'booking_info' => [
        // Include booking information as shown in authorize example
    ]
])->send();
```

### Purchase (Authorize + Capture)

[](#purchase-authorize--capture)

```
$response = $gateway->purchase([
    'amount' => '10.00',
    'currency' => 'AUD',
    'cardReference' => 'vault-token',
    'reference' => 'merchant_ref_001',
    'description' => 'Make purchase',
    'booking_info' => [
        // Include booking information as shown in authorize example
    ]
])->send();
```

### Refund a Transaction

[](#refund-a-transaction)

```
$response = $gateway->refund([
    'amount' => '10.00',
    'chargeReference' => 'original-charge-reference',
    'transactionReference' => 'original-transaction-reference',
    'booking_info' => [
        // Include booking information as shown in authorize example
    ]
])->send();
```

### Response Handling

[](#response-handling)

```
if ($response->isSuccessful()) {
    // Transaction was successful
    $chargeReference = $response->getChargeReference();
    $transactionReference = $response->getTransactionReference();
} else {
    // Transaction failed
    echo $response->getMessage();
}
```

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 announcements, 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/), or better yet, fork the library and submit a pull request.

omnipay-kovena
==============

[](#omnipay-kovena-1)

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance47

Moderate activity, may be stable

Popularity9

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 66.7% 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 ~6 days

Total

2

Last Release

411d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/19bcedf6d558330d903fe9fbe18276028702f1ed3fd28d627f7fadd10dbdebdf?d=identicon)[kovena-technology](/maintainers/kovena-technology)

---

Top Contributors

[![jason-nabooki](https://avatars.githubusercontent.com/u/52981451?v=4)](https://github.com/jason-nabooki "jason-nabooki (2 commits)")[![kovena-technology](https://avatars.githubusercontent.com/u/202911852?v=4)](https://github.com/kovena-technology "kovena-technology (1 commits)")

---

Tags

paymentgatewaypaymerchantomnipaypurchasekovena

### Embed Badge

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

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

###  Alternatives

[lokielse/omnipay-alipay

Alipay gateway for Omnipay payment processing library

587421.0k11](/packages/lokielse-omnipay-alipay)

PHPackages © 2026

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