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

ActiveLibrary[Payment Processing](/categories/payments)

bummzack/omnipay-postfinance
============================

Postfinance Gateway for the Omnipay payment processing library

1.0.1(3y ago)654.2k↓46.6%5[4 issues](https://github.com/bummzack/omnipay-postfinance/issues)2MITPHP

Since Jan 4Pushed 3y ago1 watchersCompare

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

READMEChangelog (3)Dependencies (4)Versions (6)Used By (2)

Omnipay: Postfinance
====================

[](#omnipay-postfinance)

**Postfinance Gateway for the Omnipay PHP payment processing library.**

[![Build Status](https://camo.githubusercontent.com/cee1fa6a1e7ddfb18270f6e07cdf661d573e1bb8d355e02b54bc4fa617451552/68747470733a2f2f6170692e7472617669732d63692e6f72672f62756d6d7a61636b2f6f6d6e697061792d706f737466696e616e63652e706e67)](https://travis-ci.org/bummzack/omnipay-postfinance)[![Code Coverage](https://camo.githubusercontent.com/571983e941104d16d6fee10ca750932becdf9ac0c163d3d4f426c0f7039fb092/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f62756d6d7a61636b2f6f6d6e697061792d706f737466696e616e63652f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/bummzack/omnipay-postfinance/?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/8c13d4ad114d33db7bdbcad436824548065c8721db75f1615a8a7558c6234ab7/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f62756d6d7a61636b2f6f6d6e697061792d706f737466696e616e63652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/bummzack/omnipay-postfinance/?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/e05d2e618f3be6c1e150b44c137d54099c4019472e7e8424db78296cc983d571/68747470733a2f2f706f7365722e707567782e6f72672f62756d6d7a61636b2f6f6d6e697061792d706f737466696e616e63652f762f737461626c65)](https://packagist.org/packages/bummzack/omnipay-postfinance)[![Latest Unstable Version](https://camo.githubusercontent.com/8612241ead580f3d7f87a8ea6457940f90d773a03c4ebeb5aba765293efd5ff3/68747470733a2f2f706f7365722e707567782e6f72672f62756d6d7a61636b2f6f6d6e697061792d706f737466696e616e63652f762f756e737461626c65)](https://packagist.org/packages/bummzack/omnipay-postfinance)[![License](https://camo.githubusercontent.com/b44cebcef23b79d8904d56ee7e49d25d858c364aff5f7371737198b243ac3658/68747470733a2f2f706f7365722e707567782e6f72672f62756d6d7a61636b2f6f6d6e697061792d706f737466696e616e63652f6c6963656e7365)](https://packagist.org/packages/bummzack/omnipay-postfinance)

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

This Gateway implements offsite payments via Postfinance. Purchase and Authorization are available, capturing an authorized payment has to be performed via Postfinance backend (not currently implemented for this Gateway).

**Please note:** This gateway cannot successfully complete your requests if you don't use an SHA-OUT signature. If you don't set the SHA-OUT signature in the Postfinance backend, callback URLs won't be supplied with any parameters, which makes it impossible to determine success or failure of a payment-request.

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

[](#installation)

Omnipay can be installed using [Composer](https://getcomposer.org/). [Installation instructions](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx).

Run the following command to install omnipay and the postfinance gateway:

```
composer require bummzack/omnipay-postfinance ~1.0

```

Configuration in the Postfinance Backend
----------------------------------------

[](#configuration-in-the-postfinance-backend)

This is the easiest way to setup your Postfinance account to work with the Omnipay Gateway:

1. In the **Global Security Parameters** tab, choose **Each parameter followed by the passphrase.** as the way to hash parameters.
2. The **Hash algorithm** can be chosen freely, but must be supplied as `hashingMethod` parameter to the gateway if you're using anything else than the default (`sha1`)
3. Make sure to supply an **SHA-IN pass phrase** in the **Data and origin verification** tab
4. Under **Transaction feedback**, make sure to check **I would like to receive transaction feedback parameters on the redirection URLs** *and* supply a **SHA-OUT pass phrase**.

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

[](#basic-usage)

Payment requests to the Postfinance Gateway must at least supply the following parameters:

- `pspId` Your postfinance account ID
- `transactionId` unique transaction ID
- `amount` monetary amount
- `currency` currency
- `language` locale code indicating the customer language preference, example: `en_US`

It is highly recommended to use SHA-IN and -OUT signatures for your requests.

```
$gateway = Omnipay::create('Postfinance');
$gateway->setPspId('myPspId');
$gateway->setShaIn('MyShaInSecret');
$gateway->setShaOut('MyShaOutSecret');
$gateway->setLanguage('de_DE');

// Send purchase request
$response = $gateway->purchase(
    [
        'transactionId' => '17',
        'amount' => '10.00',
        'currency' => 'CHF'
    ]
)->send();

// This is a redirect gateway, so redirect right away
$response->redirect();
```

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance7

Infrequent updates — may be unmaintained

Popularity35

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 93% 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 ~595 days

Total

5

Last Release

1406d ago

Major Versions

0.1.2 → 1.0.02019-10-18

### Community

Maintainers

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

---

Top Contributors

[![bummzack](https://avatars.githubusercontent.com/u/1006185?v=4)](https://github.com/bummzack "bummzack (40 commits)")[![aimeos](https://avatars.githubusercontent.com/u/8647429?v=4)](https://github.com/aimeos "aimeos (2 commits)")[![robjmills](https://avatars.githubusercontent.com/u/110251?v=4)](https://github.com/robjmills "robjmills (1 commits)")

---

Tags

paymentgatewaypaymerchantomnipaypostfinance

### Embed Badge

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

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

###  Alternatives

[omnipay/payfast

PayFast driver for the Omnipay payment processing library

24626.9k3](/packages/omnipay-payfast)[sudiptpa/omnipay-nabtransact

National Australia Bank (NAB) Transact driver for the Omnipay payment processing library.

1017.2k](/packages/sudiptpa-omnipay-nabtransact)[lucassmacedo/omnipay-mercadopago

MercadoPago gateway for OmniPay

154.6k](/packages/lucassmacedo-omnipay-mercadopago)

PHPackages © 2026

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