jagdish-j-p / billdesk-hmac
Package to integrate BillDesk Payment gateway with HMAC Encryption in Laravel
Fund package maintenance!
jagdish-j-p
paypal.me/jagdishjptl
www.buymeacoffee.com/jagdish.j.ptl
Requires
- php: >=7.2
- guzzlehttp/guzzle: ^7.3
- laravelcollective/html: ^6.2
- monolog/monolog: ^2.2
- web-token/jwt-core: 2.2.10
- web-token/jwt-key-mgmt: 2.2.10
- web-token/jwt-signature: 2.2.10
- web-token/jwt-signature-algorithm-hmac: 2.2.10
This package is auto-updated.
Last update: 2024-11-28 04:39:58 UTC
README
Repository has been developed to integrate BillDesk Payment Gateway with HMAC Encryption in Laravel.
This repository is currently in development. There might be some exception.
Become a sponsor
Your support allows me to keep this package free, up-to-date and maintainable. Alternatively, you can spread the word!
Installation
You can install the package via composer:
composer require jagdish-j-p/billdesk-hmac
Then run the publish command to publish the config files and support controller and view
php artisan billdesk:publish
This will generate the following files
- The config file with default setup for you to override
billdesk.php
- The controller that will receive payment response and any host-to-host events
Http/Controllers/BilldeskHmac/Controller.php
- The assets in public directory.
- The view file with default html for you to override
payment.blade.php
. Note do not change form action URLbilldesk.payment.auth.request
.
Setups
- Add your response urls and your Merchant Id, Client Id and HMAC Key to the
.env
file.
BILLDESK_TRANSACTION_RESPONSE_PATH=billdesk/payments/transactions/callback BILLDESK_MANDATE_RESPONSE_PATH=billdesk/payments/mandates/callback BILLDESK_WEBHOOK_PATH=billdesk/payments/webhook BILLDESK_MERCHANT_ID= BILLDESK_CLIENT_ID= BILLDESK_HMAC_KEY= BILLDESK_MERCHANT_LOGO="${APP_URL}/assets/img/logo.jpg" BILLDESK_RETRY_COUNT=3 BILLDESK_CHILD_WINDOW=false BILLDESK_ITEM_CODE=DIRECT BILLDESK_UAT_PREFIX="test-prefix"
- Run migration to add the transactions table
php artisan migrate
Usage
-
You can visit http://app.test/billdesk/initiate/payment for the payment flow demo of web integration.
-
Handle the payment response in
Http/Controllers/BilldeskHmac/Controller.php
/** * This will be called after the user approve the mandate * @param Request $request * * @return Response */ public function mandateCallback(MandateModifyResponseRequest $request, $id = null) { $response = $request->handle($id); if ($response['response_format'] == 'JSON') { return response()->json(['response' => $response, 'billdesk_response' => $request->all()]); } dd($response, $request); // Remove this line and modify as per your needs. } /** * This will be called after the user approve the payment * on the bank side * * @param Request $request * @return Response */ public function callback(Request $request) { $response = $request->handle(); if ($response['response_format'] == 'JSON') return response()->json(['response' => $response, 'billdesk_response' => $request->all()]); dd($response, $request); // Remove this line and modify as per your needs. // Update your order status } /** * This will handle any direct call from BillDesk * * @param Request $request * @return string */ public function webhook(Request $request) { $response = $request->handle(); // Update your order status return 'OK'; }
- Check Status of all pending transactions using command
php artisan billdesk:transaction-status
- Check Status of specific transaction using command pass comma saperated order reference ids.
php artisan billdesk:transaction-status --orderid=orderid1 --orderid=orderid2 --orderid=orderid3
- Check transaction status from Controller
use JagdishJP\BilldeskHmac\Facades\BilldeskHmac; /** * Returns status of transaction * * @param string $orderid reference order id * @return array */ $status = BilldeskHmac::getTransactionStatus($orderid);
You can also override payment.blade.php
with your custom design to integrate with your layout. but do not change name
attribute of html controls and action
URL of form.
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Contrubuters are welcome and will be given full credit.
Security
If you discover any security related issues, please email jagdish.j.ptl@gmail.com instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.
Packagify
This package was generated using the Packagify.