Cryptocurrency payments are becoming a legitimate option for online stores, but integrating them reliably requires the right infrastructure. The Bagisto BitPay Payment Gateway extension bridges this gap for Laravel-based stores, handling invoice generation, payment processing, and automatic order updates through webhooks.
What happened
- Extension: Bagisto BitPay Payment Gateway by Webkul
- Current version: 2.4.4
- Supported framework: Bagisto v2.4.4
- Payment flow: Invoice creation, customer redirect, webhook confirmation
- Modes: Sandbox for testing, live mode for production
What the Extension Does
This extension adds BitPay as a payment option within Bagisto's checkout flow. When a customer selects BitPay, the system generates an invoice on the BitPay platform and redirects the buyer to complete payment. Once BitPay confirms the transaction through its webhook system, Bagisto automatically updates the order status without manual intervention.
Key capabilities include secure invoice generation through BitPay's infrastructure, sandbox mode for testing without processing real funds, automatic order status synchronization via webhooks, and configurable display options including title, description, and logo. The admin panel handles all configuration, requiring no direct code changes after installation.
Installation Process
Installing the extension involves three main steps. First, unzip the extension package and merge the "packages" folder into the project's root directory. Second, open composer.json and add the PSR-4 autoloading configuration for the BitPay namespace. Third, run composer dump-autoload to register the new classes.
The next step adds the service provider to bootstrap/providers.php, making the extension available throughout the application. Once these steps complete, the BitPay option appears in the admin panel under Sales > Payment Methods.
Admin Configuration
After installation, navigate to Set up > Sales > Payment method > BitPay to access the settings panel. Required fields include the Merchant Facade API Token from your BitPay merchant dashboard. Toggle sandbox mode on to test transactions before accepting real cryptocurrency payments.
Additional settings control whether the payment method is enabled, the title displayed at checkout, the description shown to customers, and a symbol for quick recognition. Clicking save applies these settings immediately to your store.
Practical Example
Say you operate a Bagisto store selling digital design assets and want to attract buyers who prefer paying with cryptocurrency. After installing the extension, you configure your BitPay API token and enable sandbox mode. Testing a complete purchase flow confirms webhook updates update order status automatically. After switching to live mode, customers can now select BitPay at checkout and pay directly from their cryptocurrency wallet, with orders updating without any manual tracking.
Our Analysis
For Bagisto store owners already familiar with BitPay's merchant services, this extension removes the primary barrier to accepting cryptocurrency: technical integration work. The webhook architecture is particularly valuable because it handles the most error-prone part of payment processing—ensuring orders actually update when payments clear.
The sandbox mode deserves attention too. Unlike some payment extensions that require real transactions to verify setup, this environment lets you confirm the entire flow works before taking actual cryptocurrency. For stores where uptime matters, that's a meaningful risk reduction.
What to Watch Next
Monitor BitPay's supported cryptocurrency list and fee structure, as these directly impact what your customers experience. If you encounter webhook issues after installation, Webkul offers support through their UVDesk ticket system for the module.
Key takeaways
- The extension handles the full cryptocurrency payment lifecycle automatically
- Sandbox testing prevents real-funds issues during setup
- Webhook-based updates eliminate manual order tracking
- Version 2.4.4 requires Bagisto v2.4.4 as the base framework
Frequently asked questions
Do I need a BitPay merchant account to use this extension?
Yes. You must register as a BitPay merchant and obtain your API token from the BitPay merchant dashboard before configuring the extension.
Which cryptocurrencies does BitPay accept?
BitPay supports multiple cryptocurrencies, but the exact list depends on BitPay's current offerings and your merchant account configuration.
How do webhook updates work?
After a customer completes payment on BitPay's platform, BitPay sends a confirmation webhook to your Bagisto store, which automatically updates the order status to paid.
Can customers cancel their orders during the BitPay payment process?
Yes. If a customer cancels on the BitPay redirect page, they return to the cart with an error message and can continue shopping or choose a different payment method.
Where can I get support if the extension isn't working?
Webkul provides support through their UVDesk ticket system at bagisto.uvdesk.com.