Documentation Index
Fetch the complete documentation index at: https://docs.bnplx.io/llms.txt
Use this file to discover all available pages before exploring further.
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 to 6.8)
- WooCommerce:
9.0+ (Tested up to 9.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
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