Download the PHP package vptrading/h5-telebirr-laravel without Composer
On this page you can find all versions of the php package vptrading/h5-telebirr-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download vptrading/h5-telebirr-laravel
More information about vptrading/h5-telebirr-laravel
Files in vptrading/h5-telebirr-laravel
Package h5-telebirr-laravel
Short Description Laravel package for H5 telebirr api
License MIT
Informations about the package h5-telebirr-laravel
Laravel Package For
Telebirr
Introduction
This Laravel package is a featherweight package to integrate Telebirr®.
Usage Guide
This is a private package, meaning there is no way to require it using composer.
Step One
Install the package using composer require vptrading/h5-telebirr-laravel
Step Two
Run the artisan command to publish the Vptrading/telebirr-laravel configuration file.
After running that command you will see a telebirr.php
configuration file in your application's config
directory.
Step Four
Open the telebirr.php
configuration file and add the key's provided to you from Telebirr®
Usage
Buy
In order to send a buy request using Telebirr® all you have to do is import the Telebirr
class where you want to use it and call the buy
static method. The Telebirr::buy()
method accepts for parameters, these are: Item name, amount, return url and shortcode.
Example
Note: The
ShortCode
is provided by Ethio Telecom
When calling that method it return a response
Response Example
Note: Make sure to store the
outTradeNo
in your database so you can fetch that transaction when you receive the notification.
Using the toPayUrl you will be redirected to Ethio Telecom's Telebirr® site where the user will be able to pay using the Telebirr® mobile app or using SMS right there from the browser.
Notify
The next is being notified when a payment is successfull. After the user has paid the amount described, Telebirr® will send you a notification on the URL you specified in the telebirr.php
config file.
Example Notification String From Telebirr®
In order to decode this, the package provides a Notify::class
with notify
static method. All you need to do is put the notification string sent from Telebirr® in to that static method and it will be decoded.
Example
Result
The result is a key-value pair array with the unique outTradeNo
for you to query your database with.
🚀 And that's it. Do your thing and Give us a star if this package helped you. 🚀