README

PaymentWall driver for the Omnipay PHP payment processing library

Omnipay is a framework agnostic, multi-gateway payment processing library for PHP 5.3+. This package implements PaymentWall support for Omnipay.

PaymentWall Paymentwall is the leading digital payments platform for globally monetizing digital goods and services. Paymentwall assists game publishers, dating sites, rewards sites, SaaS companies and many other verticals to monetize their digital content and services.

Installation

Omnipay is installed via Composer. To install, simply add it to your composer.json file:

{
    "require": {
        "delatbabel/omnipay-paymentwall": "dev-master"
    }
}

And run composer to update your dependencies:

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

Basic Usage

The following transactions are provided by this package via the REST API:

Create a purchase
Tokenizing a card and using a stored token

For general usage instructions, please see the main Omnipay repository. There are also examples in the class API documentation.

Quirks

There is no separate createCard message in this gateway. The PaymentWall gateway only supports card creation at the time of a purchase. Instead, a cardReference is returned when a purchase message is sent, as a component of the response to the purchase message. This card token can then be used to make purchases in place of card data, just like other gateways.

Refunds are not supported, these must be done manually via the gateway web interface.

Required fields when making a purchase include:

accountId
packageId (account id will be used if this is not set)
packageName (description will be used if this is not set)

TODO

Use of iFrames for UnionPay and AliPay (China).

Unit Testing

Tests are in the tests folder. Basic unit tests are in place for most of the code including mock message responses.

API Documentation

You can build the API documentation after running composer update, by using this command (on Linux/Unix systems):

./makedoc.sh

The API documentation will be built in documents/main in HTML format.

Support

If you are having general issues with Omnipay, we suggest posting on Stack Overflow. Be sure to add the omnipay tag so it can be easily found.

If you want to keep up to date with release anouncements, discuss ideas for the project, or ask more detailed questions, there is also a mailing list which you can subscribe to.

omnipay / paymentwall

Maintainers

Details