alfallouji / php_optimal_netbanx
An OOP PHP Client for the Card payments Optimal Netbanx Restful service
Installs: 5 487
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 2
Open Issues: 0
Requires
- php: >=5.3.0
This package is not auto-updated.
Last update: 2024-10-26 16:54:17 UTC
README
PHP-Optimal-Netbanx
This is an OOP PHP Client for the Card payments Optimal Netbanx Restful service.
Authors & contact
Al-Fallouji Bashar - bashar@alfallouji.com
Documentation and download
Latest version is available on github at : - http://github.com/alfallouji/PHP-Optimal-Netbanx
License
This Code is released under the GNU LGPL
Please do not change the header of the file(s).
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU Lesser General Public License for more details.
How to setup
You can use composer to use this library.
{
"require": {
"alfallouji/php_optimal_netbanx": "*"
}
}
You can use composer to generate autoload map files.
composer dumpautoload
How to start
This PHP client works with the Netbanx service (card payments).
You will need an account with Optimal Payment in order to use this library.
You can create testing account here : https://developer.optimalpayments.com/en/
Configuration
In order for you to use the NETBANX REST API, NETBANX must first set you up on their system and provide you with an API key. Your API key looks something like this:
- Key ID – MerchantXYZ
- Key Password – B-tst1-0-51ed39e4-312d02345d3f123120881dff9bb4020a89e8ac44cdfdcecd702151182fdc952272661d290ab2e5849e31bb03deede7
- Account ID - 12345678
They are available from : https://developer.optimalpayments.com/en/my-account/
Please note that on the Optimal My Account page, the API key contains the Key ID and the Key Password. It has the following the format :
API_KEY_ID:API_KEY_PASSWORD
Sample
For an example, you can look at the tests/Functional folder.
/**
* Helper function for test
*
* @param boolean $v Value to assert
*
* @return void
*/
function assertTest($v)
{
if ($v)
{
echo "\t[OK]" . PHP_EOL;
}
else
{
echo "\t[FAILED]" . PHP_EOL;
exit(-1);
}
}
$auth = new \Optimal\Netbanx\Model\Authorization();
$auth->merchantRefNum = 'refNum_' . uniqid();
$auth->amount = 10000 + rand(200, 3000);
$auth->settleWithAuth = false;
$card = new \Optimal\Netbanx\Model\Card();
$card->cardNum = '4530910000012345';
$card->type = 'VI';
$card->lastDigits = '2345';
$expiry = new \Optimal\Netbanx\Model\CardExpiry();
$expiry->month = 11;
$expiry->year = 2019;
$card->cardExpiry = $expiry;
$auth->card = $card;
$billingDetails = new \Optimal\Netbanx\Model\BillingDetails();
$billingDetails->street = '511 rue abelard';
$billingDetails->zip = 'H3E 1B6';
$billingDetails->city = 'Verdun';
$billingDetails->country = 'CA';
$auth->billingDetails = $billingDetails;
$httpClient = new \Optimal\Netbanx\Client\Http($config['apiKey'], $config['apiPassword'], $config['accountId'], 'staging');
$service = new \Optimal\Netbanx\Service\Authorization($httpClient);
// Test 1 - create auth
echo PHP_EOL . 'Testing Authorization creation for ' . $auth->amount;
$result = $service->create($auth);
$id = isset($result['result']['id']) ? $result['result']['id'] : null;
assertTest($id);
// Test 2 - get auth
echo PHP_EOL . 'Testing Authorization get for ' . $id;
$result = $service->get($id);
$getId = isset($result['result']['id']) ? $result['result']['id'] : null;
assertTest($getId && $getId == $id);
// Test 3 - partial reverse of auth
$authReversal = new \Optimal\Netbanx\Model\AuthorizationReversal();
$authReversal->id = $getId;
$authReversal->amount = rand(500, 1000);
$authReversal->merchantRefNum = 'Reverse_for_' . $auth->merchantRefNum;
echo PHP_EOL . 'Testing Authorization reverse for an amount of ' . $authReversal->amount;
$result = $service->reverse($getId, $authReversal);
assertTest(isset($result['result']['status']) && $result['result']['status'] == 'COMPLETED');
// Test 4 - settle authorization
echo PHP_EOL . 'Testing Authorization settlement';
$result = $service->settle($id, array('merchantRefNum' => $auth->merchantRefNum));
assertTest($result['code'] == 200 && isset($result['result']['id']));```