PHPackages bajjour/billplz-pkg - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Payment Processing](/categories/payments) 4. / 5. bajjour/billplz-pkg ActiveLibrary[Payment Processing](/categories/payments) bajjour/billplz-pkg =================== A Laravel package for Billplz payment gateway 1.0.0(1y ago)162MITPHPPHP ^8.0 Since Mar 18Pushed 1y ago1 watchersCompare [ Source](https://github.com/bajjour/billplz)[ Packagist](https://packagist.org/packages/bajjour/billplz-pkg)[ RSS](/packages/bajjour-billplz-pkg/feed)WikiDiscussions main Synced 3w ago READMEChangelogDependencies (2)Versions (2)Used By (0) Billplz Payment Gateway for Laravel =================================== [](#billplz-payment-gateway-for-laravel) This package provides a simple and easy-to-use interface to interact with the **Billplz Payment Gateway API (v3 and v5)** in Laravel applications. It includes methods for managing collections, payments, and retrieving payment-related information. --- Installation ------------ [](#installation) You can install the package via Composer: ``` composer require bajjour/billplz-pkg ``` Configuration ------------- [](#configuration) After installing the package, publish the configuration file: ``` php artisan vendor:publish --provider="Billplz\BillplzServiceProvider" --tag="billplz-config" ``` Update your .env file with your Billplz API credentials: ``` BILLPLZ_API_KEY="your-api-key" BILLPLZ_API_VERSION="v5" BILLPLZ_XSIGNATURE="your-x-signature" #applied in v5 only BILLPLZ_API_URL="https://www.billplz-sandbox.com/api" #in production use live url ``` Usage ----- [](#usage) `Initialize the Service` You can initialize the Billplz service in your controller: ``` use Billplz\Services\BillplzService; public function __construct(BillplzService $billplz) { $this->billplz = $billplz; } ``` `List Available Payment Gateways` Retrieve a list of available payment gateways. ``` $gateways = $this->billplz->list_gateways(); ``` Response ``` //v5 response { "payment_gateways":[{ "code":"BP-BST01", "active":true, "category":"boost", "extras": { "name":null, "visibility":true, "available":true, "isFpx":null, "isObw":null, "isConsent":null } },{ "code":"MBBM2U2", "active":false, "category":"fpx", "extras":{ "name":null, "visibility":false, "available":true, "isFpx":null, "isObw":null, "isConsent":null } }, ...... } //v3 response { "banks":[ {"name":"MBBM2U2", "active":false}, {"name":"MB2U0227", "active":true}, {"name":"PBB0233", "active":true}, ...... } ``` `Create a Collection` Create a new collection for payments. ``` $response = $this->billplz->createCollection( title: 'Campaign {id}', callback_url: 'https://example.com/callback' ); ``` Response ``` //v5 response { "id":"ab66c9f0-9944-4373-a586-86c58420b27b", "title":"Campaign {id}", "payment_orders_count":0, "paid_amount":0, "status":"active", "callback_url":"https:\/\/your-callback.url\/" } //v3 response { "id":"h6bltqha", "title":"CAMPAIGN {ID}", "logo":{"thumb_url":null,"avatar_url":null}, "split_payment":{"email":null,"fixed_cut":null,"variable_cut":null,"split_header":false} } ``` `Get Collection Details` Retrieve details of a specific collection. ``` $response = $this->billplz->getCollection('your_collection_id'); ``` Response ``` //v5 response { "id":"ab66c9f0-9944-4373-a586-86c58420b27b", "title":"Campaign {id}", "payment_orders_count":0, "paid_amount":0, "status":"active", "callback_url":"https:\/\/your-callback.url\/" } //v3 response { "id":"h6bltqha", "title":"CAMPAIGN {ID}", "logo":{"thumb_url":null,"avatar_url":null}, "split_payment":{"email":null,"fixed_cut":null,"variable_cut":null,"split_header":false}, "status":"active" } ``` `Get Payment Order Limit` Available only for v5 and used to retrieve the payment order limit for your account. ``` $response = $this->billplz->paymentOrderLimit(); ``` Response ``` //v5 response {"total":99700} ``` `Create a Payment` Create a new payment. for bank\_code in sandbox use "DUMMYBANKVERIFIED", for live use the code returned from list\_gateways() function. ``` //v5 parameters $response = $this->billplz->createPayment([ 'payment_order_collection_id' => 'ab66c9f0-9944-4373-a586-86c58420b27b', 'bank_code' => 'DUMMYBANKVERIFIED', 'bank_account_number' => 'customer bank account number', 'name' => 'customer name', 'description' => 'payment description', 'total' => 'amount', //smallest currency unit (e.g 100 cents to charge RM 1.00) ]); //v3 parameters $response = $this->billplz->createPayment([ 'collection_id' => 'h6bltqha', 'email' => 'customer email', 'name' => 'customer name', 'amount' => 'amount', //smallest currency unit (e.g 100 cents to charge RM 1.00) 'callback_url' => 'https://example.com/callback', 'description' => 'payment description' ]); ``` Response ``` //v5 response { "id":"88da8ef2-c1cf-45c0-891a-9ac2ee0be03b", "payment_order_collection_id":"ab66c9f0-9944-4373-a586-86c58420b27b", "bank_code":"DUMMYBANKVERIFIED", "bank_account_number":"customer bank account number", "name":"customer name", "description":"payment description", "email":"customer email", "status":"enquiring", "notification":false, "recipient_notification":true, "reference_id":null, "display_name":null, "total":2000 } //v3 response { "id":"5a0b8533516768cb", "collection_id":"h6bltqha", "paid":false, "state":"due", "amount":100, "paid_amount":0, "due_at":"2025-3-18", "email":"bajjour.89@gmail.com", "mobile":null, "name":"BADR AJJOUR", "url":"https:\/\/www.billplz-sandbox.com\/bills\/5a0b8533516768cb", "reference_1_label":"Reference 1", "reference_1":null, "reference_2_label":"Reference 2", "reference_2":null, "redirect_url":null, "callback_url":"shamel.site", "description":"101 RM for Campaign 10", "paid_at":null } ``` `Get Payment Details` Retrieve details of a specific payment. in v3 use paid = true to know if bill has paid. in v5 use status = completed to know if bill has paid. ``` $this->billplz->getPayment(payment_id: 'your_payment_id') ``` Response ``` //v5 response { "id":"88da8ef2-c1cf-45c0-891a-9ac2ee0be03b", "payment_order_collection_id":"ab66c9f0-9944-4373-a586-86c58420b27b", "bank_code":"DUMMYBANKVERIFIED", "bank_account_number":"customer bank account number", "name":"customer name", "description":"payment description", "email":"customer email", "status":"completed", "notification":false, "recipient_notification":true, "reference_id":null, "display_name":"customer name", "total":2000 } //v3 response { "id":"5a0b8533516768cb", "collection_id":"h6bltqha", "paid":false, "state":"due", "amount":100, "paid_amount":0, "due_at":"2025-3-18", "email":"customer email", "mobile":null, "name":"customer name", "url":"https:\/\/www.billplz-sandbox.com\/bills\/5a0b8533516768cb", "reference_1_label":"Reference 1", "reference_1":null, "reference_2_label":"Reference 2", "reference_2":null, "redirect_url":null, "callback_url":"https://example.com/callback", "description":"payment description", "paid_at":null } ``` API Documentation ----------------- [](#api-documentation) For more details about the Billplz API, refer to the official documentation: [billplz API](https://www.billplz-sandbox.com/api#introduction) License ------- [](#license) [MIT](https://choosealicense.com/licenses/mit/) ### Health Score 28 — LowBetter than 52% of packages Maintenance42 Moderate activity, may be stable Popularity12 Limited adoption so far Community7 Small or concentrated contributor base Maturity43 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 462d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/058005445fca254ef9441c3e3c2d44f687888160d542fe1cead1be1bb4b34bba?d=identicon)[bajjour.89@gmail.com](/maintainers/bajjour.89@gmail.com) --- Top Contributors [![bajjour](https://avatars.githubusercontent.com/u/1816757?v=4)](https://github.com/bajjour "bajjour (6 commits)") ### Embed Badge ![Health badge](/badges/bajjour-billplz-pkg/health.svg) ``` [![Health](https://phpackages.com/badges/bajjour-billplz-pkg/health.svg)](https://phpackages.com/packages/bajjour-billplz-pkg) ``` ### Alternatives [spatie/laravel-responsecache Speed up a Laravel application by caching the entire response 2.8k8.7M64](/packages/spatie-laravel-responsecache)[propaganistas/laravel-disposable-email Disposable email validator 6012.9M7](/packages/propaganistas-laravel-disposable-email)[harris21/laravel-fuse Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures. 43140.3k](/packages/harris21-laravel-fuse)[iazaran/smart-cache Smart Cache is a caching optimization package designed to enhance the way your Laravel application handles data caching. It intelligently manages large data sets by compressing, chunking, or applying other optimization strategies to keep your application performant and efficient. 2119.7k](/packages/iazaran-smart-cache)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)