PHPackages                             shopblocks-engineering/omnipay-realex - 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. shopblocks-engineering/omnipay-realex

ActiveLibrary[Payment Processing](/categories/payments)

shopblocks-engineering/omnipay-realex
=====================================

Realex driver with 3D Secure & refund support for Omnipay payment processing library

5.5.3(4y ago)016.7k↓19.9%MITPHP

Since Aug 21Pushed 3y agoCompare

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

READMEChangelog (2)Dependencies (3)Versions (43)Used By (0)

Omnipay: Realex
===============

[](#omnipay-realex)

**Realex driver with 3D Secure support for Omnipay payment processing library**

[![Build Status](https://camo.githubusercontent.com/aaaa29ed5ffe20b94eabdec48209e841ad4aaa97ef59e2a9e42dcafbe3d17f10/68747470733a2f2f7472617669732d63692e6f72672f646967697469636b6574732f6f6d6e697061792d7265616c65782e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/digitickets/omnipay-realex)[![Latest Stable Version](https://camo.githubusercontent.com/71c499cdfe68df5e9b97dae6e1405d6ad0636767ae2af098b01af993c278ccae/68747470733a2f2f706f7365722e707567782e6f72672f646967697469636b6574732f6f6d6e697061792d7265616c65782f76657273696f6e2e706e67)](https://packagist.org/packages/digitickets/omnipay-realex)[![Total Downloads](https://camo.githubusercontent.com/d5b176c53d0ca2243c1cbb21d7901c84c532bc97855d79ae868fc7b1fb2d1cd7/68747470733a2f2f706f7365722e707567782e6f72672f646967697469636b6574732f6f6d6e697061792d7265616c65782f642f746f74616c2e706e67)](https://packagist.org/packages/digitickets/omnipay-realex)

[Omnipay](https://github.com/omnipay/omnipay) is a framework agnostic, multi-gateway payment processing library for PHP 5.3+. This package implements Realex (Remote MPI) integration for Omnipay, including optional 3D Secure support.

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

[](#installation)

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

```
{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/shopblocks-engineering/omnipay-realex.git"
        }
    ]
}
```

```
{
    "require": {
        "shopblocks-engineering/omnipay-realex": "*"
    }
}
```

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:

- Realex\_Remote

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

3D Secure
---------

[](#3d-secure)

The Realex driver has 3D Secure checking turned off by default. To enable 3D Secure, make sure you have received a 3D Secure account reference from Realex, then set the `3dSecure` parameter as '1' when you initialise the gateway.

Refunds
-------

[](#refunds)

In order to process a refund, you must configure the gateway with the `refundPassword` parameter set to the 'rebate' password that Realex provide you with. In addition, you will need to pass the following parameters, relating to the original transaction: `amount`, `transactionReference`, `transactionId`, `currency`, `authCode`.

Saved Cards
-----------

[](#saved-cards)

To save a card, you need to supply the `customerRef` and `cardReference` parameters. If the customer reference doesn't exist on Realex (you can check this with `$response->customerDoesntExist()` ), you must create the customer using `$gateway->createCustomer()`. Once the customer & card is setup, you can authorise a payment by supplying the card reference & customer reference instead of the card details:

```
$gateway->purchase(
    [
        'transactionId' => $transactionId,
        'customerRef'   => $customerRef,
        'amount'        => $amount,
        'currency'      => $currency,
        'cardReference' => $cardRef,
        'card'          => ['cvv' => $cvv]
    ]
);
```

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity75

Established project with proven stability

 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.

###  Release Activity

Cadence

Every ~71 days

Recently: every ~35 days

Total

40

Last Release

1519d ago

Major Versions

v2.1.3 → v3.0.02015-01-08

v3.2.0 → v4.0.02015-09-14

4.1.1 → 5.0.02016-11-17

v4.0.4 → 5.52021-11-02

### Community

Maintainers

![](https://www.gravatar.com/avatar/3f800619ba21f2d791473b112c3d7bf51765a284e1fe24f3f9e31b491420e1d2?d=identicon)[shopblocks](/maintainers/shopblocks)

---

Top Contributors

[![shopblocks](https://avatars.githubusercontent.com/u/14819903?v=4)](https://github.com/shopblocks "shopblocks (10 commits)")[![cfreear](https://avatars.githubusercontent.com/u/619726?v=4)](https://github.com/cfreear "cfreear (10 commits)")[![ProjectZero4](https://avatars.githubusercontent.com/u/23586974?v=4)](https://github.com/ProjectZero4 "ProjectZero4 (4 commits)")[![cameronshopblocks](https://avatars.githubusercontent.com/u/54808522?v=4)](https://github.com/cameronshopblocks "cameronshopblocks (2 commits)")[![CJMillard](https://avatars.githubusercontent.com/u/61282091?v=4)](https://github.com/CJMillard "CJMillard (2 commits)")[![Marcus-Nightingale](https://avatars.githubusercontent.com/u/47229647?v=4)](https://github.com/Marcus-Nightingale "Marcus-Nightingale (2 commits)")[![slogsdon](https://avatars.githubusercontent.com/u/647624?v=4)](https://github.com/slogsdon "slogsdon (2 commits)")[![psaunders88](https://avatars.githubusercontent.com/u/4922659?v=4)](https://github.com/psaunders88 "psaunders88 (1 commits)")[![seonzoo](https://avatars.githubusercontent.com/u/7262729?v=4)](https://github.com/seonzoo "seonzoo (1 commits)")[![lewisvgd](https://avatars.githubusercontent.com/u/10810802?v=4)](https://github.com/lewisvgd "lewisvgd (1 commits)")[![philwc](https://avatars.githubusercontent.com/u/617110?v=4)](https://github.com/philwc "philwc (1 commits)")

---

Tags

paymentgatewaypaymerchantomnipaypurchaserealex

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/shopblocks-engineering-omnipay-realex/health.svg)

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

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