NAB Transact XML API Integration

Author: sudiptpa

.coveralls.yml

@@ -0,0 +1,2 @@
+coverage_clover: ./clover.xml
+json_path: ./coveralls-upload.json

.gitignore

@@ -0,0 +1,7 @@
+/vendor
+composer.lock
+composer.phar
+phpunit.xml
+php-cs-fixer.phar
+phpcbf.phar
+phpcs.phar

.scrutinizer.yml

@@ -0,0 +1,2 @@
+tools:
+    external_code_coverage: true

.travis.yml

@@ -0,0 +1,16 @@
+language: php
+
+php:
+  - 5.3
+  - 5.4
+  - 5.5
+  - 5.6
+  - 7.0
+  - hhvm
+
+before_script:
+  - composer install -n --dev --prefer-source
+
+script: vendor/bin/phpcs --standard=PSR2 src && vendor/bin/phpunit --coverage-text
+
+after_script: vendor/bin/coveralls -v

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,88 @@
+# Omnipay: NAB Transact
+
+**NAB Transact driver for the Omnipay PHP payment processing library**
+
+[Omnipay](https://github.com/thephpleague/omnipay) is a framework agnostic, multi-gateway payment
+processing library for PHP 5.3+. This package implements NAB Transact support for Omnipay.
+
+[![StyleCI](https://styleci.io/repos/73980655/shield?branch=master)](https://styleci.io/repos/73980655)
+[![Build Status](https://travis-ci.org/sudiptpa/nabtransact.svg?branch=master)](https://travis-ci.org/sudiptpa/nabtransact)
+[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/sudiptpa/nabtransact/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/sudiptpa/nabtransact/?branch=master)
+[![Latest Stable Version](https://poser.pugx.org/sudiptpa/nabtransact/version.png)](https://packagist.org/packages/sudiptpa/nabtransact)
+
+## Installation
+
+Omnipay is installed via [Composer](http://getcomposer.org/). To install, simply add it
+to your `composer.json` file:
+
+```json
+{
+    "require": {
+        "sudiptpa/nabtransact": "~2.0"
+    }
+}
+```
+
+And run composer to update your dependencies:
+
+    $ curl -s http://getcomposer.org/installer | php
+    $ php composer.phar update
+
+## Basic Usage
+
+The following gateways are provided by this package:
+
+* NAB Transact SecureXML API*
+
+```php
+    use Omnipay\Omnipay;
+    use Omnipay\Common\CreditCard;
+
+    $gateway = Omnipay::create('NABTransact_SecureXML');
+    $gateway->setMerchantId('ABC0001');
+    $gateway->setTransactionPassword('abc123');
+    $gateway->setTestMode(true);
+ 
+    $card = new CreditCard(
+        [
+            'number'      => '4444333322221111',
+            'expiryMonth' => '6',
+            'expiryYear'  => '2020',
+            'cvv'         => '123',
+        ]
+    );
+ 
+    $transaction = $gateway->purchase(
+        [
+            'amount'        => '10.00',
+            'currency'      => 'AUD',
+            'transactionId' => 'XYZ100',
+            'card'          => $card,
+        ]
+    );
+ 
+    $response = $transaction->send();
+ 
+    if ($response->isSuccessful()) {
+        echo sprintf('Transaction %s was successful!', $response->getTransactionReference());
+    } else {
+        echo sprintf('Transaction %s failed: %s', $response->getTransactionReference(), $response->getMessage());
+    }
+
+```
+
+For general usage instructions, please see the main [Omnipay](https://github.com/thephpleague/omnipay)
+repository.
+
+## 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 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](https://groups.google.com/forum/#!forum/omnipay) which
+you can subscribe to.
+
+If you believe you have found a bug, please report it using the [GitHub issue tracker](https://github.com/sudiptpa/nabtransact/issues),
+or better yet, fork the library and submit a pull request.

composer.json

@@ -0,0 +1,39 @@
+{
+    "name": "sudiptpa/omnipay-nabtransact",
+    "type": "library",
+    "description": "NAB Transact driver for the Omnipay payment processing library",
+    "keywords": [
+        "gateway",
+        "merchant",
+        "omnipay",
+        "pay",
+        "payment",
+        "nabtransact"
+    ],
+    "homepage": "https://github.com/sudiptpa/nabtransact",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Sujip Thapa",
+            "email": "sudiptpa@gmail.com"
+        }
+    ],
+    "autoload": {
+        "psr-4": { 
+            "Omnipay\\NABTransact\\" : "src/"
+        }
+    },
+    "require": {
+        "omnipay/common": "~2.3"
+    },
+    "require-dev": {
+        "omnipay/tests": "~2.0",
+        "satooshi/php-coveralls": "1.0.0",
+        "fzaninotto/faker": "~1.4"
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-master": "2.0.x-dev"
+        }
+    }
+}

phpunit.xml.dist

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit backupGlobals="false"
+         backupStaticAttributes="false"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false"
+         syntaxCheck="false">
+    <testsuites>
+        <testsuite name="NAB Transact Test Suite">
+            <directory>./tests/</directory>
+        </testsuite>
+    </testsuites>
+    <listeners>
+        <listener class="Mockery\Adapter\Phpunit\TestListener" file="vendor/mockery/mockery/library/Mockery/Adapter/Phpunit/TestListener.php" />
+    </listeners>
+    <filter>
+        <whitelist>
+            <directory>./src</directory>
+        </whitelist>
+    </filter>
+</phpunit>

src/Message/AbstractRequest.php

@@ -0,0 +1,61 @@
+<?php
+
+namespace Omnipay\NABTransact\Message;
+
+/**
+ * NABTransact Abstract Request.
+ */
+abstract class AbstractRequest extends \Omnipay\Common\Message\AbstractRequest
+{
+    /**
+     * @var mixed
+     */
+    public $testEndpoint;
+
+    /**
+     * @var mixed
+     */
+    public $liveEndpoint;
+
+    /**
+     * @return mixed
+     */
+    public function getMerchantId()
+    {
+        return $this->getParameter('merchantId');
+    }
+
+    /**
+     * @param $value
+     * @return mixed
+     */
+    public function setMerchantId($value)
+    {
+        return $this->setParameter('merchantId', $value);
+    }
+
+    /**
+     * @return mixed
+     */
+    public function getTransactionPassword()
+    {
+        return $this->getParameter('transactionPassword');
+    }
+
+    /**
+     * @param $value
+     * @return mixed
+     */
+    public function setTransactionPassword($value)
+    {
+        return $this->setParameter('transactionPassword', $value);
+    }
+
+    /**
+     * @return mixed
+     */
+    public function getEndpoint()
+    {
+        return $this->getTestMode() ? $this->testEndpoint : $this->liveEndpoint;
+    }
+}