User Guide for Bagisto BitPay Payment Gateway

Bagisto BitPay Payment Gateway brings fast, secure cryptocurrency checkout to your Laravel store, using BitPay invoice creation and webhook-based order updates to keep payments reliable for customers.

• Secure checkout using BitPay invoice creation and redirect flow.
• Supports both Sandbox and Live modes to verify integration safely.
• Accepts cryptocurrency payments through the BitPay gateway.
• Automatically creates and redirects customers to a BitPay invoice.
• Uses webhooks to update order status after payment confirmation.
• Easy admin configuration with token, title, description, logo, and sort order.

Unzip the respective extension zip and then merge “packages” folder into project root directory.

Next, goto composer.json file and add following line under ‘psr-4’

"Webkul\\Bitpay\\": "packages/Webkul/Bitpay/src"

Run the following command to refresh the autoload files:

composer dump-autoload

Goto bootstrap/providers.php file and add following line under the array.

use Webkul\Bitpay\Providers\BitpayPaymentServiceProvider;

return [
    BitpayPaymentServiceProvider::class,
]

Configure BitPay settings in the Admin Panel.

• Navigate to Configure → Sales → Payment Methods → BitPay
• Configure the following settings:
  • Merchant Facade API Token
  • Sandbox Mode
  • Enable/Disable Payment Method
  • Title
  • Description
  • Logo

• Log in to your Bagisto Admin Panel.
• Click on Configure from the left sidebar.

Open Payment Methods

• Under Configure, select Sales.
• Click on Payment Methods.

Navigate to BitPay Settings

• Find BitPay in the payment methods list.
• Click to open the BitPay settings panel.

Enable BitPay

• Locate the Status toggle.
• Switch it ON to enable BitPay.

Enter BitPay API Token

• Enter your BitPay API Token from the BitPay merchant dashboard.
• Use the token to enable secure invoice creation and payment processing.

Enable Sandbox Mode

• Turn on Sandbox to test BitPay without live funds.
• Turn sandbox off for real production payments.

Set Title, Description, and Logo

• Enter a checkout Title for customers.
• Add a Description so buyers know BitPay is supported.
• Upload a Logo to make BitPay easy to identify.

Save Configuration

After entering all settings, click Save to apply BitPay to your store.

Mini Checkout Page

Customers add products to the cart and tap Continue to Checkout to begin the payment flow.

Checkout Address

Choose the shipping address and continue to the payment method section.

Payment Method

Select BitPay as the payment method and click to place the order.

BitPay Redirect Page

Customers are redirected to the BitPay checkout page. They complete payment using the available crypto options and then return to Bagisto.

If payment succeeds, the order is created. If the customer cancels, they return to the cart with an error message.

Success Order

Once the BitPay payment is successful, customers see the order confirmation page and can view the order ID.

Customers can also review payment method details in their order history and invoice.

Admins can view BitPay orders in the sales section and verify the chosen payment gateway for each order.

Open the order to see the payment method labelled as BitPay.

Support

That’s all for the Bagisto BitPay Payment Gateway, still have any issue feel free to add a ticket and let us know your views to make the module better at bagisto.uvdesk.com