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
📞 Support
- Email: contact@greenbanana.group
- Website: https://www.greenbanana.group