PHPackages                             superbrave/omnipay-icepay-payments - 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. superbrave/omnipay-icepay-payments

ActiveLibrary[Payment Processing](/categories/payments)

superbrave/omnipay-icepay-payments
==================================

Icepay Payments support (excluding Afterpay) for Omnipay payment processing library.

1.5.0(4y ago)41.4k2[2 PRs](https://github.com/superbrave/omnipay-icepay-payments/pulls)MITPHPPHP ^7.2.9

Since May 17Pushed 3y ago2 watchersCompare

[ Source](https://github.com/superbrave/omnipay-icepay-payments)[ Packagist](https://packagist.org/packages/superbrave/omnipay-icepay-payments)[ Docs](https://github.com/superbrave/omnipay-icepay-payments)[ RSS](/packages/superbrave-omnipay-icepay-payments/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (10)Dependencies (4)Versions (23)Used By (0)

Omnipay: Icepay Payments (ICEX2.0)
==================================

[](#omnipay-icepay-payments-icex20)

[![Build Status](https://camo.githubusercontent.com/51b7bab0403e279f02a858d453d014921db4988351b3bfac1266e2c691d5820b/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f737570657262726176652f6f6d6e697061792d6963657061792d7061796d656e74732f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/superbrave/omnipay-icepay-payments/build-status/master)[![Code Coverage](https://camo.githubusercontent.com/505315617f9e5a3bd38a4f9492069930d0e97a6ad0d73204eaa54e43b2440e16/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f737570657262726176652f6f6d6e697061792d6963657061792d7061796d656e74732f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/superbrave/omnipay-icepay-payments/?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/85b2eba1f6f92d5e9990b3924f9f391162602cd9e21165a04813c5400b3ec742/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f737570657262726176652f6f6d6e697061792d6963657061792d7061796d656e74732f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/superbrave/omnipay-icepay-payments/?branch=master)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

Introduction
------------

[](#introduction)

[Omnipay](https://github.com/thephpleague/omnipay) is a framework agnostic, multi-gateway payment processing library for PHP 7.2.9+. This package implements Icepay Payments support for Omnipay and it supports ICEX2.0. Therefore you need a `SecretKey` and a `ContractProfileId` (also known as `UserId`).

*Do note that this implementation does not support Authorise-Capture (for Afterpay) yet.*

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

[](#installation)

To install, simply add it to your `composer.json` file:

```
$ composer require superbrave/omnipay-icepay-payments
```

Initialization
--------------

[](#initialization)

First, create the Omnipay gateway:

```
$gateway = Omnipay\Omnipay::create('\Omnipay\IcepayPayments\Gateway');
// or
$gateway = new \Omnipay\IcepayPayments\Gateway(/* $httpClient, $httpRequest */);
```

Then, initialize it with the correct credentials:

```
$gateway->initialize([
    'secretKey' => $secretKey, // The given secret key.
    'contractProfileId' => $contractProfileId, // The given contract profile id or user id.
    'testMode' => false // Optional, default: true
]);
// or
$gateway->setSecretKey($secretKey);
$gateway->setContractProfileId($contractProfileId);
```

Usage
-----

[](#usage)

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

### General flow

[](#general-flow)

1. [Create a transaction](#transaction).
2. Check for the [transaction status](#status).
3. Perform one [refund(s)](#refund) operations if needed.

### Transaction

[](#transaction)

To create a new order, use the `transaction` method:

```
$data = [
    'Contract' => [
        'ContractProfileId' => '85cf0581-36e2-45c7-8d8c-a24c6f52902c',
        'AmountInCents' => 1337,
        'CurrencyCode' => 'EUR',
        'Reference' => '829c7998-6497-402c-a049-51801ba33662',
    ],
    'Postback' => [
        'UrlCompleted' => 'https://www.superbrave.nl/return-url',
        'UrlError' => 'https://www.superbrave.nl/cancel-url',
        'UrlsNotify' => [
            'https://www.superbrave.nl/notify-url',
        ],
    ],
    'IntegratorFootprint' => [
        'IPAddress' => '127.0.0.1',
        'TimeStampUTC' => '0',
    ],
    'ConsumerFootprint' => [
        'IPAddress' => '127.0.0.1',
        'TimeStampUTC' => '0',
    ],
    'Fulfillment' => [
        'PaymentMethod' => 'IDEAL',
        'IssuerCode' => 'ABNAMRO',
        'AmountInCents' => 1337,
        'CurrencyCode' => 'EUR',
        'Consumer' => [
            'Address' => [
                'CareOf' => null,
                'City' => 'Bree duh',
                'CountryCode' => 'NL',
                'HouseNumber' => null,
                'PostalCode' => '4817 HX',
                'Street' => 'Quite 18',
            ],
            'Category' => 'Person',
        ],
        'Timestamp' => '2019-03-09T12:00:00Z',
        'LanguageCode' => 'nl',
        'CountryCode' => 'NL',
        'Reference' => '829c7998-6497-402c-a049-51801ba33662',
        'Order' => [
            'OrderNumber' => '12345AB',
            'CurrencyCode' => 'EUR',
            'TotalGrossAmountCents' => 1337,
            'TotalNetAmountCents' => 1337,
        ],
        'Description' => '829c7998-6497-402c-a049-51801ba33662',
    ],
];

$request = $gateway->authorize($data);

$response = $response->send();
```

[API documentation](http://docs2.icepay.com/calling-our-webservice/transaction-functions/)

### Status

[](#status)

```
$data = [
    'ContractProfileId' => '85cf0581-36e2-45c7-8d8c-a24c6f52902c',
    'AmountInCents' => 1337,
    'CurrencyCode' => 'EUR',
    'Reference' => '829c7998-6497-402c-a049-51801ba33662',
];

$request = $gateway->fetchTransaction($data);

$response = $request->send();
```

[API documentation](https://documentation.icepay.com/api/#operation/Get%20Transaction)

### Refund

[](#refund)

*Do note: refunds implementation has not been tested.*

```
$data = [
    'ContractProfileId' => '85cf0581-36e2-45c7-8d8c-a24c6f52902c',
    'AmountInCents' => 1337,
    'CurrencyCode' => 'EUR',
    'Reference' => '829c7998-6497-402c-a049-51801ba33662',
];

$request = $gateway->refund($data);

$response = $request->send();
```

[API documentation](https://documentation.icepay.com/api/#operation/Refund)

License
-------

[](#license)

This omnipay gateway is under the MIT license. See the [complete license](LICENSE).

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity64

Established project with proven stability

 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 ~68 days

Recently: every ~167 days

Total

15

Last Release

1590d ago

Major Versions

0.1.0 → 1.0.02019-05-21

### Community

Maintainers

![](https://www.gravatar.com/avatar/f5f344c666ed6e0cf73ec40895b4dd76b8a4d9a50d963c88f6307f20ca6e8909?d=identicon)[jellevo](/maintainers/jellevo)

---

Top Contributors

[![kiettran](https://avatars.githubusercontent.com/u/2773245?v=4)](https://github.com/kiettran "kiettran (84 commits)")[![krijn-sb](https://avatars.githubusercontent.com/u/42442010?v=4)](https://github.com/krijn-sb "krijn-sb (39 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![twanhaverkamp](https://avatars.githubusercontent.com/u/38506134?v=4)](https://github.com/twanhaverkamp "twanhaverkamp (1 commits)")

---

Tags

icepayicepay-paymentsicex20omnipayomnipay-gatewayphpphp7php72paymentgatewaypaymerchantomnipaypurchaseicepay

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/superbrave-omnipay-icepay-payments/health.svg)

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

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