# Setup and Configuration

The **Convergegate WooCommerce Gateway** plugin enables merchants to accept payments and manage recurring billing directly through WooCommerce. This plugin integrates seamlessly with the Convergegate API, supporting credit/debit card payments and rebill functionality.

### 🔧 Installation

1. Download and install the **Convergegate WooCommerce Gateway** plugin.
2. In your WordPress dashboard, go to **Plugins → Add New**.
3. Upload the plugin `.zip` file and click **Install Now**.
4. Activate the plugin.

{% file src="/files/JAF05wTrpdhMkOoa7R9f" %}

### ⚙️ Configuration

Once installed, configure the gateway by navigating to:

`WooCommerce → Settings → Payments → Convergegate Payment`

You will see the following configuration screen:

<figure><img src="/files/ymguv75sc1utZsT7PQh0" alt=""><figcaption></figcaption></figure>

#### General Settings

* **Enable/Disable**\
  Check this box to enable Convergegate as a payment method in your store.
* **Title**\
  The payment method name displayed to customers during checkout.\
  \&#xNAN;*Example:* `Woocommerce Payment Gateway for Convergegate`
* **Description**\
  A short description shown to customers at checkout.\
  \&#xNAN;*Example:* `Pay easily through Convergegate using your preferred method.`

***

#### API Settings

* **Base URL**\
  Enter the Convergegate API base URL. \
  Use the sandbox environment for testing:\
  `https://engine-sandbox.convergegate.com`\
  For production, use:\
  `https://engine.convergegate.com`
* **API Key**\
  Your unique API key provided by Convergegate.\
  \&#xNAN;*(Keep this secure and do not share it.)*
* **Notification URL**\
  This is the webhook endpoint used by Convergegate to send payment updates.\
  Example:\
  `https://yourdomain.com/wc-api/convergegate_webhook`

#### Payment Options

* **Allowed Payment Methods**\
  Select which payment methods to allow (e.g., Credit/Debit Card).
* **Start Recurring**\
  Enable this option to allow recurring/rebill payments.
* **Pre-Authorization** *(optional)*\
  Allows 2-phase charges (authorize first, capture later).
* **Send Card Data Directly** *(PCI DSS only)*\
  If your system is PCI DSS compliant, you may enable direct card data sending. Otherwise, leave unchecked.
* **Additional Parameters (JSON)**\
  Optional advanced configuration in JSON format. Example:

### 🔄 Recurring Payments (Rebill)

When **Recurring Payment Chain** is enabled:

* Customers can subscribe to products or services.
* The gateway automatically handles rebills according to WooCommerce Subscriptions logic.
* Webhooks update payment status (success, failed, canceled).

***

### ✅ Testing the Gateway

1. Enable **Sandbox Mode** using the sandbox base URL.
2. Place a test order in WooCommerce checkout.
3. Confirm webhook notifications update the order status.
4. Once verified, switch to the production base URL and live API key.

***

### 📌 Troubleshooting

* **Payments not updating?**\
  Ensure your **Notification URL** is reachable and properly configured.
* **Invalid API Key?**\
  Verify the key matches the one provided in your Convergegate dashboard.
* **Recurring payments failing?**\
  Confirm that rebill is enabled both in the plugin and in your Convergegate account.

***

### 📷 Screenshots

**Plugin Configuration**

<figure><img src="/files/wazZyNu9F1uFxElKWyPN" alt=""><figcaption></figcaption></figure>

**Checkout page with Convergegate option**

<div align="left"><figure><img src="/files/Re2LPefDphHyBsDxGmuj" alt=""><figcaption></figcaption></figure></div>

**WooCommerce Convergegate payment**

<figure><img src="/files/A84hjfWBUiBv7BqoB7vL" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.convergegate.com/v1/woocommerce-gateway/setup-and-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.