A laravel package for theteller payment gateway
PHP 5.4+ and Composer are required.
If you have your own server, make sure php-curl is installed.
apt-get install php-curlTo get the latest version of Thetallara, simply require it
composer require kalkulus/thetallaraOr add the following line to the require block of your composer.json file.
"kalkulus/thetallara": "1.0.*"
You'll then need to run composer install or composer update to download it and have the autoloader updated.
Once Thetellara is installed, you need to register the service provider. Open up config/app.php and add the following to the providers key.
'providers' => [
...
Kalkulus\Thetellara\ThetellaraServiceProvider::class,,
...
]If you use Laravel >= 5.5 you can skip this step and go to
configuration
Kalkulus\Thetellara\ThetellaraServiceProvider::class,
Also, register the Facade like so:
'aliases' => [
...
'Thetellara' => Kalkulus\Thetellara\ThetellaraServiceProvider::class,
...
]You can publish the configuration file using this command:
php artisan vendor:publish --provider="Kalkulus\Thetellara\ThetellaraServiceProvider"A configuration-file named theteller.php with some sensible defaults will be placed in your config directory:
<?php
return [
/**
* Your environment. Either Production (prod) or Test (test)
*
*/
'tellerEnv' => getenv('THETELLER_ENV', 'test'),
/**
* Merchant ID From Theteller Dashboard
*
*/
'merchantId' => getenv('THETELLER_MERCHANT_ID'),
/**
* Theteller API Username
*
*/
'apiUsername' => getenv('THETELLER_API_USERNAME'),
/**
* Theteller API Key
*
*/
'apiKey' => getenv('THETELLER_API_KEY'),
/**
* Theteller Redirect Url
*
*/
'redirectUrl' => getenv('THETELLER_REDIRECT_URL'),
];Though there are multiple ways to pay an order, most payment gateways expect you to follow the following flow in your checkout process:
After the customer has gone through the checkout process and is ready to pay, the customer must be redirected to the site of the payment provider.
The redirection is accomplished by submitting a form with some hidden fields. The form must send a POST request to the site of the payment provider. The hidden fields minimally specify the amount that must be paid, the order id and a hash.
The hash is calculated using the hidden form fields and a non-public secret. The hash used by the payment provider to verify if the request is valid.
The customer arrives on the site of the payment provider and gets to choose a payment method. All steps necessary to pay the order are taken care of by the payment provider.
After having paid the order the customer is redirected back. In the redirection request to the shop-site some values are returned. The values are usually the order id, a payment result and a hash.
The hash is calculated out of some of the fields returned and a secret non-public value. This hash is used to verify if the request is valid and comes from the payment provider. It is paramount that this hash is thoroughly checked.
Open your .env file and add your public key, secret key, merchant email and payment url like so:
THETELLER_ENV=xxxx
THETELLER_MERCHANT_ID=xxxxxxxxxxxx
THETELLER_REDIRECT_URL=http://baseurl/payment/callback
THETELLER_API_USERNAME=xxxxxxxxxxxxxx
THETELLER_API_KEY=xxxxxxxxxxxxxxxxxxSet the THETELLER_ENV to test if your just testing and prod if you are going on production.
If you are using a hosting service like heroku, or digitalocean app platform, etc ensure to add the above details to your configuration variables.
Set up routes and controller methods like so:
// Laravel 8
Route::post('/pay', [App\Http\Controllers\PaymentController::class, 'redirectToGateway'])->name('pay');Route::get('/payment/callback', 'PaymentController@handleGatewayCallback');Make sure to register the callback url in your env
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Kalkulus\Thetellara\Thetellara;
use Illuminate\Support\Facades\Redirect;
class PaymentController extends Controller
{
/**
* Redirect the User to Theteller Payment Page
* @return Url
*/
public function redirectToGateway()
{
$transactionId = mt_rand(100000000000,999999999999); // Must be unique for all transactions...
// You may use the function I wrote below for unique transaction id `genTransactionId()`
// In that case you keep track of the transaction IDs in payments table in the database.
// Hence call it as $transactionId = $this->genTransactionId();
$email = request()->input('email'); //Customer email
$amount = request()->input('amount');; //Amount with is in pesewas. So 200 is actually GHS 2.00
$desc = request()->input('desc');
try{
$theteller = new Thetellara();
$response = $theteller->initialize($transactionId, $email, $amount, $desc);
return redirect($response->checkout_url);
}catch(\Exception $e) {
return Redirect::back()->withMessage(['error'=>'The transaction has expired']);
}
}
/**
* Get Theteller payment information
* @return void
*/
public function handleGatewayCallback()
{
$theteller = new Thetellara();
$response = $theteller->getPaymentDetails();
dd($response);
// Now you have the payment details,
// you can then redirect or do whatever you want
}
/**
* Get unique transaction ID
* @return string
*/
private function genTransactionId(){
$this->transactionId = [
'transactionId' => mt_rand(100000000000,999999999999)
];
$rules = ['transactionId' => 'unique:payments'];
$validate = Validator::make($this->transactionId, $rules)->passes();
return $validate ? $this->transactionId['transactionId'] : $this->genTransactionId();
}
}<form action="{{ route('pay') }}" method="POST">
@csrf
<input type="hidden" name="amount" value="200"> {{-- required in pesewas. Set it up here and request it in your controller --}}
<input type="hidden" name="email" value="[email protected]"> {{-- Required --}}
<input type="hidden" name="desc" value="Theteller Payment Request"> {{-- Required --}}
<button type="submit" class="btn btn-primary">Pay</button>
</form>- Direct payments -> Card and Mobile Money
- Fund transfer
- Add Comprehensive Tests
- Implement Transaction Dashboard to see all of the transactions in your laravel app
Please feel free to fork this package and contribute by submitting a pull request to enhance the functionalities.
Why not star the github repo? I'd love the attention! Why not share the link for this repository on Twitter or any where? Spread the word!
Don't forget to follow me on twitter!
Thanks!
Mumuni Mohammed.
The MIT License (MIT). Please see License File for more information.
I got inspiration from Unideveloper
Thanks to Prosper Otemuyiwa!