Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.paybridgenp.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

The Buy Now button lets customers skip the cart and Shopify checkout, going directly from a product page to PayBridge’s hosted checkout. Customers pay with eSewa, Khalti, or Fonepay in just two clicks.
Buy with PayBridgeNP button on a Shopify product page

Setup

Step 1: Enable in app settings

  1. Open your Shopify admin and go to Apps > PayBridgeNP > Settings
  2. Under “Alternative flows”, check Enable the Buy with PayBridgeNP button
  3. Click Save settings

Step 2: Add the block to your theme

  1. Go to Online Store > Themes > Customize
  2. Navigate to a product page using the page selector at the top
  3. In the left sidebar under “Product information”, click Add block
  4. Switch to the Apps tab
  5. Select PayBridge Buy Now
Adding the PayBridge Buy Now block from the Apps tab
  1. The block is added to your product page. Drag it to your preferred position (below “Buy it now” is recommended)
PayBridge Buy Now block positioned in the theme editor sidebar
  1. Click Save
The PayBridge Buy Now block only appears on product pages. You won’t see it on the homepage or collection pages.

Step 3: Customize the button

You can customize the button in two places:

Option A: From the theme editor

Click the “PayBridge Buy Now” block in the sidebar to open its settings panel:
PayBridge Buy Now block settings panel showing button text, color, and toggle options
Go to Apps > PayBridgeNP > Settings and scroll to the Buy Now button design section. Changes here apply globally across all product pages.
If you set values in both places, the app settings take priority over the theme editor settings. The theme editor acts as a per-page override.

Available settings

SettingDescriptionDefault
Button textThe text displayed on the button”Buy with PayBridgeNP”
Button colorThe background color of the button#667eea (PayBridge blue)
Show price on buttonWhether to append the variant price (e.g. ”- Rs5.00”)On
Show provider iconsDisplay “Pay with eSewa, Khalti, Fonepay” below the buttonOn

How it works

When a customer clicks the Buy Now button:
  1. Order created - A Shopify order is created for the selected variant and quantity
  2. Redirect - The customer is redirected to PayBridge’s hosted checkout page, which shows the product name and amount
  3. Payment - The customer pays with their preferred provider (eSewa, Khalti, or Fonepay)
  4. Order paid - The Shopify order is automatically marked as paid
  5. Customer info - The customer’s name, email, and phone from the checkout are added to the Shopify order
The entire flow takes about 30 seconds from click to payment.
PayBridge hosted checkout page showing product name, amount, and payment providers

Features

  • Variant-aware - The button automatically updates when the customer selects a different size, color, or option
  • Quantity sync - Picks up the quantity from the product page’s quantity selector
  • Out-of-stock handling - Button is disabled and shows “Sold Out” for unavailable variants
  • Mobile responsive - Full-width button that works on all screen sizes
  • Double-click protection - Shows a loading spinner and prevents duplicate orders
  • Product name in checkout - The checkout page and receipt email include the product name and order reference

Customer experience

After clicking the button, the customer sees:
  1. A brief “Preparing your payment…” loading page (1-3 seconds while the order is created)
  2. The PayBridge hosted checkout page showing the product name, amount, and payment options
  3. The provider’s payment page (eSewa or Khalti)
  4. A “Verifying your payment…” page (1-2 seconds)
  5. The Shopify order confirmation page

Merchant experience

Orders created via the Buy Now button:
  • Appear in your Shopify admin under Orders like any other order
  • Are tagged for easy filtering in your admin order list
  • Include a note identifying them as PayBridgeNP Buy Now orders
  • Show the customer’s email and phone number (collected on the checkout page)
  • Support refunds through the PayBridge dashboard
Full theme editor view showing the Buy with PayBridgeNP button on a Shopify product page

FAQ

Yes. The Buy Now button is independent of the thank-you page payment flow. Customers can still use “Add to cart” and go through Shopify’s normal checkout with your configured manual payment method. Both flows work simultaneously.
The Buy Now button works with all Online Store 2.0 themes (Dawn, Refresh, and any theme from the Shopify Theme Store). Vintage/legacy themes are not supported.
The order stays in “Payment pending” status. If you have SMS/email reminders enabled, the customer will receive reminders. After 48 hours (configurable), the order is automatically cancelled.
Yes. Inventory is deducted when the order is created, before the customer reaches the checkout page. If the customer doesn’t pay, inventory is automatically released after the expiry window.
Yes. The app settings set global defaults for all product pages. To override on a specific page, use the theme editor: click the “PayBridge Buy Now” block on that product’s template and change the settings there. Theme editor values override app settings on that page only.
The button appears on all product pages that use the same template. To remove it from a specific product, create a separate product template in the theme editor without the PayBridge Buy Now block, and assign that template to the product.