NopFashion Theme + 15 Plugin Bundle for NopCommerce NopBeauty Theme + 12 Plugin Bundle for NopCommerce NopNoor Theme + 16 Plugin Bundle for NopCommerce
BSS AI SEO Assistant BSS AI Business Assistant
BSS Nop REST API Plugin BSS Nop Flutter Mobile App + REST API
BSS Google Authentication BSS Microsoft Authentication BSS Phone SMS Authentication
BSS EU GDPR Cookie Consent BSS EU Omnibus Directive
BSS One Page Checkout BSS bKash Payment BSS SSLCommerz Payment BSS Stripe Payment BSS Mollie Payment BSS Payment Change BSS Cart Reminder BSS PDF Invoice Designer BSS Paddle Payment
BSS Ajax Filter
BSS Steadfast Shipping Plugin BSS Pathao Shipping Plugin
BSS Banner BSS Anywhere Swiper BSS Anywhere Slider BSS SCarousels BSS Anywhere Carousels BSS Top Trends
BSS Product Ribbon BSS Chat BSS QuickView BSS Picture Zoom BSS Anywhere Component BSS Product Details BSS Product Box

BSS Paddle Payment

Created on: May 13, 2026

The BSS Paddle Payment plugin serves as a comprehensive Merchant of Record, handling all global tax calculations, invoicing, and payment processing on behalf of the store. It provides a secure, modern checkout overlay with multiple payment methods and ensures that no sensitive customer payment information is stored locally. Merchants can manage the integration through settings for API authentication, additional transaction fees, and a webhook system for transaction events.
PRE-REQUISITES

  • The plugin requires you to install the BSS Core plugin first.

INSTALLATION

  • Download the BSS Paddle Payment plugin from our store https://store.bssoln.com/

  • Go to Administration → Configuration → Local plugins

  • Upload the BSS.PaddlePayment zip file using the ‘Upload plugin or theme’ button

 

  • After uploading, install the ‘BSS Core’ Plugin first.

  • Then scroll down or write the name of the plugin in the search bar to find and install ‘BSS Paddle Payment’

  • To make the plugins functional, restart the application

  • After installation the plugin will show in the menu.
CONFIGURE

  • Go to Admin → BSS → Plugins → Paddle → Configuration

  • Enter the License string and save it. Then clear cache.

  • Then again go to BSS → Plugins → Paddle → Configuration to link your store with your Paddle account and manage transaction costs.

PADDLE SETTINGS

  • Authentication: You must provide your API Key, Client Token, and Webhook Secret from your Paddle dashboard to authorize transactions.

  • Sandbox Mode: A checkbox that allows you to toggle between the live environment and a testing environment for verifying the payment flow.

  • Additional Fees: You can set an Additional Fee to be charged when customers select this payment method.

  • Fee Type: The Additional Fee: Use Percentage checkbox determines whether the added charge is a fixed amount or a percentage of the total order.

WEBHOOK CONFIGURATION

  • This section provides the necessary information to keep your store synchronized with Paddle's payment status updates.

  • Webhook URL: The plugin generates a specific Webhook URL that you must copy and configure as a notification destination in the Paddle dashboard under Developer Tools > Notifications.

  •  Event Subscriptions: Within your Paddle account (under Developer Tools > Notifications), you can subscribe to a wide range of events. For proper plugin functionality, we recommend subscribing to key ones such as:

    • transaction.completed

    • transaction.paid

    • transaction.payment_failed

    • adjustment.created

    • adjustment.updated

  • Once these settings are entered and saved, Paddle will serve as the Merchant of Record, handling all payment processing, tax calculations, and invoicing on behalf of your store.

PUBLIC VIEW

FEATURES

  • Automated Tax & Invoicing: Paddle handles all payment processing, tax calculations (such as VAT), and invoicing on behalf of your store.

  • Multiple Payment Methods: Supports secure checkout using a variety of global methods, including PayPal and major Credit/Debit cards such as Visa, Mastercard, and American Express.

  • Professional Checkout UI: Utilizes a secure, modern overlay for transactions that provides a clear order summary, including subtotal and tax breakdowns.

  • Real-time Webhook Synchronization: Uses a dedicated Webhook URL to receive instant updates from Paddle for various events, such as when a transaction is completed, paid, or fails.

  • Sandbox Environment: Includes a Sandbox Mode toggle that allows administrators to safely test the entire payment and webhook flow before processing live transactions.

  • Flexible Transaction Fees: Allows merchants to set an Additional Fee for choosing this payment method, as either a fixed amount or a percentage of the total order.