Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.ligdicash.com/llms.txt

Use this file to discover all available pages before exploring further.

The LigdiCash plugin for WooCommerce is installed manually from a ZIP file. Once enabled, it adds a payment gateway to your WooCommerce admin — no code to write. Download the plugin (ZIP) What the plugin does:
  • Adds a LigdiCash payment method to the WooCommerce checkout page
  • Redirects the customer to the LigdiCash payment page during checkout
  • Receives the confirmation callback and automatically updates the order status
  • Adds CFA franc (XOF) currency support to WooCommerce

​
Requirements

  • WordPress ≥ 4.x
  • WooCommerce installed and enabled
  • A LigdiCash API project with an api_key and auth_token — see Create an API project
  • Store currency set to XOF or FCFA

​
Installation

The plugin is installed by downloading the folder as a ZIP file and importing it into WordPress.
1

Download the plugin

Download the ZIP file via the link at the top of this page or directly: plugin-wordpress.zip.
2

Import into WordPress

From your WordPress dashboard, go to Plugins → Add New → Upload Plugin, select the .zip file, then click Install Now.
3

Activate the plugin

Once installation is complete, click Activate Plugin.
4

Open the settings

Go to WooCommerce → Settings → Payments, then click LigdiCash to open the configuration page.

​
Configuration

From WooCommerce → Settings → Payments → LigdiCash:
FieldDescription
Enable/DisableTick to show LigdiCash as a payment method at checkout
TitleText shown to the customer on the checkout page (e.g. Mobile payment, VISA…)
DescriptionDescription shown below the title on the checkout page
Main keyYour api_key generated in the LigdiCash dashboard
TokenYour auth_token generated in the LigdiCash dashboard
Never share your Main key or Token — they grant access to your merchant account. Do not commit them to your Git repository.

​
Payment flow

Once the plugin is configured, here’s what happens on each order:
1

The customer places an order

On the WooCommerce checkout page, the customer picks LigdiCash as the payment method and confirms.
2

Redirect to LigdiCash

The plugin creates an invoice via POST /pay/v01/redirect/checkout-invoice/create and redirects the customer to the LigdiCash payment page.
3

Customer pays

The customer picks their mobile money operator and completes the payment on the LigdiCash page.
4

Return to the store

After payment, the customer is redirected to the WooCommerce confirmation page. The plugin checks the status via GET /pay/v01/redirect/checkout-invoice/confirm/ and updates the order.
5

Callback confirmation

LigdiCash also sends a POST callback to {your-site}/wc-api/wc_ligdicash/. The plugin handles this callback and marks the order as Completed if the status is completed.
The callback URL is generated automatically by the plugin: {your-site}/wc-api/wc_ligdicash/. You don’t need to configure it manually — it’s registered in WooCommerce when the plugin is activated.

​
Currency

The plugin automatically adds the FCFA (XOF) currency to WooCommerce. Set your store currency to XOF or FCFA under WooCommerce → Settings → General.