PHPackages                             digitickets/omnipay-savvy-gift-card - 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. digitickets/omnipay-savvy-gift-card

ActiveLibrary[Payment Processing](/categories/payments)

digitickets/omnipay-savvy-gift-card
===================================

Savvy Gift Card driver for the Omnipay payment processing library

v1.0.0(5y ago)036.3k↓41.5%1MITPHP

Since Oct 29Pushed 5y ago2 watchersCompare

[ Source](https://github.com/digitickets/omnipay-savvy-gift-card)[ Packagist](https://packagist.org/packages/digitickets/omnipay-savvy-gift-card)[ Docs](https://github.com/digitickets/omnipay-savvy-gift-card)[ RSS](/packages/digitickets-omnipay-savvy-gift-card/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (3)Versions (4)Used By (0)

omnipay-savvy-gift-card
=======================

[](#omnipay-savvy-gift-card)

**Savvy Gift Card redemptions driver for the Omnipay PHP payment processing library**

Omnipay implementation of Savvy Gift Card redemption. Obviously it's not a payment gateway, but it behaves in a similar way.

See [their technical documentation](https://developer.savvyconnectdirect.net/) for more details.

[![Build Status](https://camo.githubusercontent.com/d8b3fbb139310462adfa998c24fef4f4d66a421f8670ce981f507389f83fc0c5/68747470733a2f2f7472617669732d63692e6f72672f646967697469636b6574732f6f6d6e697061792d73617676792d676966742d636172642e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/digitickets/omnipay-savvy-gift-card)[![Latest Stable Version](https://camo.githubusercontent.com/559c76008667271c6060821e56a01f69a4a244221fe831d50f08ea697bd1471b/68747470733a2f2f706f7365722e707567782e6f72672f646967697469636b6574732f6f6d6e697061792d73617676792d676966742d636172642f76657273696f6e2e706e67)](https://packagist.org/packages/omnipay/savvy-gift-card)[![Total Downloads](https://camo.githubusercontent.com/4205b16f59d942dc9350d2d6690e1d62957527f11f244d843aa782dc23c6a3f1/68747470733a2f2f706f7365722e707567782e6f72672f646967697469636b6574732f6f6d6e697061792d73617676792d676966742d636172642f642f746f74616c2e706e67)](https://packagist.org/packages/digitickets/omnipay-savvy-gift-card)

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

[](#installation)

**Important: Driver requires [PHP's Intl extension](http://php.net/manual/en/book.intl.php) to be installed.**

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

```
{
    "require": {
        "digitickets/omnipay-savvy-gift-card": "^1.0"
    }
}
```

And run composer to update your dependencies:

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

```

What's Included
---------------

[](#whats-included)

The driver for Savvy Gift Cards. It allows you to validate and redeem a card, and reverse a previous redemption.

It supports making requests with and without a PIN.

It can automatically revert a redemption where there were insufficient funds.

What's Not Included
-------------------

[](#whats-not-included)

This driver does not handle any of the other card management operations, such as loading a card, unfreezing, unloading, doing an ad hoc refund, etc.

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

[](#basic-usage)

For the driver in this repo, there are voucher-type requests, namely validate, redeem and unredeem, and there is a subset of the normal "Omnipay" requests, namely authorize, purchase and refund.

Use the voucher-type requests when you're treating the vouchers as vouchers; use the "Omnipay" requests when you are treating them as payments.

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

### Running with/without a PIN

[](#running-withwithout-a-pin)

By default, the driver assumes that you are using PINs; it will call the endpoints that require a PIN.

There is a parameter, `usePIN`. If true, it assumes you are using PINs. If false, it assumes you are not using PINs and will call the "\*nopin" endpoints where necessary. It defaults to true.

### Handling redemptions with insufficient funds

[](#handling-redemptions-with-insufficient-funds)

If you attempt to redeem a gift card where the redemption amount is greater than the current balance on the card, the API will reduce the current balance to zero and return a response code of "30".

This is not ideal as money has been taken off the card, but the API returns an error.

There is therefore a parameter, `failOnInsufficientFunds` to say what to do. If true, it will immediately revert the redemption (so the card ends up with the balance that it started with) and will return the original, error, response.

If set to false, it will simply adjust the response to have a response code of "0" and an amount equal to the actual amount taken off the card, and do nothing else. In this case, it's up to the merchant to compare the requested amount with the response amount to detect if there were insufficient funds.

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 believe you have found a bug in this driver, please report it using the [GitHub issue tracker](https://github.com/digitickets/omnipay-savvy-gift-card/issues), or better yet, fork the library and submit a pull request.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~3 days

Total

3

Last Release

2021d ago

Major Versions

v0.1.1 → v1.0.02020-11-04

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/23523887?v=4)[DigiTickets](/maintainers/DigiTickets)[@digitickets](https://github.com/digitickets)

---

Top Contributors

[![pedanticantic](https://avatars.githubusercontent.com/u/7499073?v=4)](https://github.com/pedanticantic "pedanticantic (1 commits)")

---

Tags

webservicegatewaymerchantomnipaygift cardSavvy

### Embed Badge

![Health badge](/badges/digitickets-omnipay-savvy-gift-card/health.svg)

```
[![Health](https://phpackages.com/badges/digitickets-omnipay-savvy-gift-card/health.svg)](https://phpackages.com/packages/digitickets-omnipay-savvy-gift-card)
```

PHPackages © 2026

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