https://github.com/sudiptpa/omnipay-nabtransact
Integrate NAB Transact payment gateway using the php library built on top of Omnipay PHP payment processing library.
https://github.com/sudiptpa/omnipay-nabtransact
nab omnipay omnipay-gateway payment payment-gateway payment-gateway-intigration payment-integration payment-platforms payments php
Last synced: 5 months ago
JSON representation
Integrate NAB Transact payment gateway using the php library built on top of Omnipay PHP payment processing library.
- Host: GitHub
- URL: https://github.com/sudiptpa/omnipay-nabtransact
- Owner: sudiptpa
- License: mit
- Created: 2016-11-20T11:25:06.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-01-27T04:19:08.000Z (over 3 years ago)
- Last Synced: 2025-10-10T20:57:59.472Z (8 months ago)
- Topics: nab, omnipay, omnipay-gateway, payment, payment-gateway, payment-gateway-intigration, payment-integration, payment-platforms, payments, php
- Language: PHP
- Homepage:
- Size: 224 KB
- Stars: 10
- Watchers: 1
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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. This package implements NAB Transact support for Omnipay.
[](https://styleci.io/repos/74269379)
[](https://travis-ci.org/sudiptpa/omnipay-nabtransact)
[](https://packagist.org/packages/sudiptpa/omnipay-nabtransact)
[](https://packagist.org/packages/sudiptpa/omnipay-nabtransact)
[](https://raw.githubusercontent.com/sudiptpa/omnipay-nabtransact/master/LICENSE)
## Installation
Omnipay is installed via [Composer](http://getcomposer.org/). To install, simply require `league/omnipay` and `sudiptpa/omnipay-nabtransact` with Composer:
```
composer require league/omnipay sudiptpa/omnipay-nabtransact
```
## Basic Usage
The following gateways are provided by this package:
* NABTransact_DirectPost (NAB Transact Direct Post v2)
* NABTransact_SecureXML (NAB Transact SecurePay XML)
* NABTransact_UnionPay (UnionPay via NAB Transact)
### NAB Transact SecureXML API
```php
use Omnipay\Omnipay;
use Omnipay\Common\CreditCard;
$gateway = Omnipay::create('NABTransact_SecureXML');
$gateway->setMerchantId('XYZ0010');
$gateway->setTransactionPassword('abcd1234');
$gateway->setTestMode(true);
$card = new CreditCard([
'firstName' => 'Sujip',
'lastName' => 'Thapa',
'number' => '4444333322221111',
'expiryMonth' => '06',
'expiryYear' => '2030',
'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());
}
```
### NAB Transact SecureXML API with Risk Management
```php
use Omnipay\Omnipay;
use Omnipay\Common\CreditCard;
$gateway = Omnipay::create('NABTransact_SecureXML');
$gateway->setMerchantId('XYZ0010');
$gateway->setTransactionPassword('abcd1234');
$gateway->setTestMode(true);
$gateway->setRiskManagement(true);
$card = new CreditCard([
'firstName' => 'Sujip',
'lastName' => 'Thapa',
'number' => '4444333322221111',
'expiryMonth' => '06',
'expiryYear' => '2030',
'cvv' => '123',
]
);
$transaction = $gateway->purchase([
'amount' => '10.00',
'currency' => 'AUD',
'transactionId' => 'XYZ100',
'card' => $card,
'ip' => '1.1.1.1',
]
);
$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());
}
```
### NAB Transact DirectPost v2
```php
$gateway = Omnipay::create('NABTransact_DirectPost');
$gateway->setMerchantId('XYZ0010');
$gateway->setTransactionPassword('abcd1234');
$gateway->setTestMode(true);
$gateway->setHasEMV3DSEnabled(true);
$card = new CreditCard(array(
'firstName' => 'Sujip',
'lastName' => 'Thapa',
'number' => '4444333322221111',
'expiryMonth' => '10',
'expiryYear' => '2030',
'cvv' => '123',
));
$response = $gateway->purchase(array(
'amount' => '12.00',
'transactionId' => 'ORDER-ZYX8',
'transactionReference' => '11fc42b0-bb7a-41a4-8b3c-096b3fd4d402'
'currency' => 'AUD',
'card' => $card,
'clientIp' => '192.168.1.1'
))
->send();
if ($response->isRedirect()) {
$response->redirect();
}
if ($response->isSuccessful()) {
echo sprintf('Transaction %s was successful!', $response->getTransactionReference());
} else {
echo sprintf('Transaction %s failed: %s', $response->getTransactionReference(), $response->getMessage());
}
```
### NAB Transact DirectPost v2 UnionPay Online Payment
```php
$gateway = Omnipay::create('NABTransact_UnionPay');
$gateway->setMerchantId('XYZ0010');
$gateway->setTransactionPassword('abcd1234');
$gateway->setTestMode(true);
/*
* The parameter transactionId must be alpha-numeric and 8 to 32 characters in length
*/
$response = $gateway->purchase(array(
'amount' => '12.00',
'transactionId' => '1234566789205067',
'currency' => 'AUD',
'returnUrl' => 'http://example.com/payment/response',
))
->send();
if ($response->isRedirect()) {
$response->redirect();
}
```
#### Complete Purchase
```php
$gateway = Omnipay::create('NABTransact_UnionPay');
$gateway->setMerchantId('XYZ0010');
$gateway->setTransactionPassword('abcd1234');
$gateway->setTestMode(true);
$response = $gateway->completePurchase(array(
'amount' => '12.00',
'transactionId' => '1234566789205067',
'transactionReference' => '11fc42b0-bb7a-41a4-8b3c-096b3fd4d402'
'currency' => 'AUD',
'returnUrl' => 'http://example.com/payment/response',
))
->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.
## Contributing
Contributions are **welcome** and will be fully **credited**.
Contributions can be made via a Pull Request on [Github](https://github.com/sudiptpa/omnipay-nabtransact).
## 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.