onubrooks / glade-pay
A small PHP library/package that uses the Glade API to make payments using bank transfer option.
Requires
- guzzlehttp/guzzle: 7.0
Requires (Dev)
- phpunit/phpunit: 9.5
README
A small PHP library/package that uses the Glade API to make payments using the bank transfer option.
Getting Started
You need to have PHP and composer installed on your machine to use this package. The latest versions of both are recommended.
Installation
You can clone this project and include the class in your project or add the dependency in your composer.json
file as in the example below:
{ "require": { "onubrooks/glade-pay": "^1.0.0" } }
Or run the following command in your project:
composer require onubrooks/glade-pay
Usage
Instantiate the GladePay Class:
require_once __DIR__ . '/vendor/autoload.php'; use onubrooks\GladePay\GladePay; $glade = new GladePay();
Pay Using Bank Transfer
$amount = 30000; $user_data = ' { "firstname":"John", "lastname":"Wick", "email":"wick@gladeuniverse.com", "ip":"192.168.10.5", "fingerprint": "cccvxbxbxbc" } '; $business_name = "Happy Glade Customer"; $user = json_decode($user_data); //Initiate a bank transfer Transaction, country and currency are optional and defaults to 'NG' and 'NGN' // user and business_name are also optional $transaction = $glade->bankTransfer($amount, $user, $business_name); //After the transaction is completed, verify to confirm final status. $verification = $glade->verify("GP61548131820210220X");
Return Values
All methods return an array.
Below are the fields returned in the array from the bankTransfer
method with sample return values:
{ "status": 202, "txnRef": "GP61548131820210220X", "auth_type": "device", "accountNumber": "9922554842", "accountName": "GladePay Demo", "bankName": "Providus Bank", "accountExpires": 600, "message": "Make a transfer into the following account using your bank app or internet banking platfrom to complete the transaction" }
For the verify method, here's a sample of the returned values in the array:
{ "status": 200, "txnStatus": "pending", "txnRef": "GP9225324020210220G", "message": "PENDING", "chargedAmount": 0, "currency": "NGN", "payment_method": "bank_transfer", "fullname": "John Wick", "email": "wick@gladeuniverse.com", "bank_message": "Awaiting Validation" }
Running Tests
The test cases can be run using the following command on windows command line:
php vendor/phpunit/phpunit/phpunit --bootstrap vendor/autoload.php tests
For bash users, use the following command:
php vendor/bin/phpunit --bootstrap vendor/autoload.php tests
Find other repos by the same author at this github profile.