> ## 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.

# WooCommerce Plugin

# BNPLX Payment Gateway for WooCommerce – Installation Guide

**Latest Plugin Version:** 1.0.4
**License:** [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html)

***

## 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](mailto: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

| 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

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

* Email: [contact@greenbanana.group](mailto:contact@greenbanana.group)
* Website: [https://www.greenbanana.group](https://www.greenbanana.group)