hosannahighertech / gateway-php
Hosanna e-Payment Gateway API PHP library
This package is auto-updated.
Last update: 2024-12-17 19:46:28 UTC
README
Requirements
PHP 5.4.0 and later.
Composer
You can install the library via Composer. Run the following command:
composer require hosannahighertech/gateway-php
To use the library, use Composer's autoload:
require_once('vendor/autoload.php');
Dependencies
The library depends on Requests Http Library
. The Library is included so you dont have to install anything.
Getting Started
1. Creating gateway Object.
To create the Gateway object you need to first define your configurations. Your configurations Object must implement hosannahighertech\gateway\interfaces\ConfigurationInterface
. This gives you flexibility to use file, session or database to store your configurations. It also does not limit on how to get such a thing as access token though you can use the bundled library for that. See src/samples
for an exmple. Assuming your configuration class is SampleConfiguration
then you can create gateway object as simple as
use hosannahighertech\gateway\Gateway; use hosannahighertech\gateway\samples\SampleConfigurations; //Your configuration file $gateway = new Gateway(new SampleConfigurations());
The Gateway object can then be used for creating Payment requests and Confirming for Receipts.
2. Sending Payment Request
To create Payment request, just create an object of PaymentRequest
class and then use gateway sendRequest
method to send that. The method returns object of RequestReceipt
containing, upon success or a null
upon failure. Use Gateway object's getError
method to get the actual error message.
use hosannahighertech\Gateway\PaymentRequest; $request = new PaymentRequest(); $request = $request->setCard('1234565432789054') ->setDescription('Buying some soda') ->setAmount(1500) ->setCurrency("TZS") ->setCompany(1) ->setTransferTo(1234567890987654); $reqReceipt = $gateway->sendRequest($request); if($reqReceipt === null) { echo $gateway->getError()); } else { //succesfully. Do something with Request Receipt }
3. Confirming Payment
Confirming Payment will do the actual deducting/transfer of the money.
To do that, just pass payment ID from RequestReceipt
object you got from previous request, using getReceipt()
method to confirmPayment
method of the Gateway object. The result will be null
in case of failure and an object of PaymentReceipt
class in case of success. Use Gateway object's getError
method to get the actual error message.
$paymentReceipt = $gateway->confirmPayment($reqReceipt->getReceipt()); if($paymentReceipt === null) { echo $gateway->getError()); } else { //succesfully. Do something with Payment Receipt }
Please refer to documentation for more details.
Documentation
Coming soon!
4. Loging
TBD
5. Testing
TBD