Installation & Setup
WooCommerce Plugin
🛠️ BNPLX Payment Gateway for WooCommerce – Installation Guide
Latest Plugin Version: 1.0.4 License: GPLv3
📋 Plugin Overview
BNPLX Payment Gateway for WooCommerce Buy now, pay later orchestration payment gateway for your WooCommerce store.
Requirements:
- WordPress:
6.0+
(Tested up to6.8
) - WooCommerce:
9.0+
(Tested up to9.9
) - PHP: Compatible with
PHP 7.4
✅ Prerequisites
Before installation:
- Ensure WordPress and WooCommerce are installed and up-to-date
- Have Admin access to your WordPress dashboard
- Request your BNPLX credentials (see next step)
📩 Step 1: Request Credentials
Email contact@greenbanana.group with:
- Your website URL
- Contact details
- Company name
🔌 Step 2: Install the Plugin
- Log in to your WordPress Admin Dashboard
- Navigate to Plugins > Add New
- Search for:
BNPLX Payment Gateway for WooCommerce
- Click Install Now, then Activate
⚙️ Step 3: Configure the Plugin
Navigate to: WooCommerce > Settings > Payments > BNPLX – Manage
Below are the configuration options available:
🔧 Core Settings
Field | Description | Default |
---|---|---|
Enable BNPLX Payment | Toggle BNPLX on/off | yes |
Hide at checkout for non-admin users | Restrict BNPLX to admins only | yes |
Turn DEV mode on/off | Enable sandbox/dev mode | yes |
🏷️ Label & Display
Field | Description | Default |
---|---|---|
Checkout label | The label shown at checkout (e.g. “Pay later”) | Pay later |
Show gender dropdown | Add gender field at checkout | yes |
Show date of birth dropdown | Add date of birth field at checkout | yes |
🔑 API Credentials
Field | Description |
---|---|
API url | Endpoint for BNPLX API (e.g., https://api.staging.bnplx.com ) |
API key | Found under “API Keys” > “Developers” in your BNPLX Dashboard |
Publishable key | Also under “API Keys” > “Developers” |
Payment response hash key | Used for webhook validation |
Business profile ID | Found under “Business Profiles” in BNPLX Settings |
💳 Payment Behavior
Field | Description | Default |
---|---|---|
Capture method | How payments are captured: currently supports manual_multiple | manual_multiple |
Order of payment methods | Control the display order. Possible values: | |
invoice , direct_debit , installment_invoice , installment_direct_debit , subscription_invoice , subscription_direct_debit | ||
invoice; direct_debit; installment_invoice; installment_direct_debit; subscription_invoice; subscription_direct_debit |
🧪 Step 4: Test the Integration
- Switch to DEV mode if testing (
Turn DEV mode on/off = yes
) - Use staging credentials provided by BNPLX
- Place a test order using the BNPLX option
- Check for the transaction in WooCommerce > Orders
🚀 Step 5: Go Live
- Replace all credentials with live production values
- Set Turn DEV mode on/off = no
- Save your settings
You’re now ready to accept live BNPLX transactions.
📞 Support
- Email: contact@greenbanana.group
- Website: https://www.greenbanana.group