🛠️ 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

  1. Log in to your WordPress Admin Dashboard
  2. Navigate to Plugins > Add New
  3. Search for: BNPLX Payment Gateway for WooCommerce
  4. 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

FieldDescriptionDefault
Enable BNPLX PaymentToggle BNPLX on/offyes
Hide at checkout for non-admin usersRestrict BNPLX to admins onlyyes
Turn DEV mode on/offEnable sandbox/dev modeyes

🏷️ Label & Display

FieldDescriptionDefault
Checkout labelThe label shown at checkout (e.g. “Pay later”)Pay later
Show gender dropdownAdd gender field at checkoutyes
Show date of birth dropdownAdd date of birth field at checkoutyes

🔑 API Credentials

FieldDescription
API urlEndpoint for BNPLX API (e.g., https://api.staging.bnplx.com)
API keyFound under “API Keys” > “Developers” in your BNPLX Dashboard
Publishable keyAlso under “API Keys” > “Developers”
Payment response hash keyUsed for webhook validation
Business profile IDFound under “Business Profiles” in BNPLX Settings

💳 Payment Behavior

FieldDescriptionDefault
Capture methodHow payments are captured: currently supports manual_multiplemanual_multiple
Order of payment methodsControl 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

  1. Switch to DEV mode if testing (Turn DEV mode on/off = yes)
  2. Use staging credentials provided by BNPLX
  3. Place a test order using the BNPLX option
  4. Check for the transaction in WooCommerce > Orders

🚀 Step 5: Go Live

  1. Replace all credentials with live production values
  2. Set Turn DEV mode on/off = no
  3. Save your settings

You’re now ready to accept live BNPLX transactions.


📞 Support