Skip to main content

WooCommerce Integration

Cashless provides a WordPress plugin for accepting mobile money payments through WooCommerce.

Installation​

  1. Download the cashless-payment-gateway plugin folder
  2. Upload it to /wp-content/plugins/ on your WordPress site
  3. Activate the plugin in WordPress Admin > Plugins
  4. Go to WooCommerce > Settings > Payments
  5. Enable "Cashless Payment Gateway" and click "Set up"

Configuration​

In the plugin settings, enter:

SettingDescription
API KeyYour Cashless API key
API SecretYour Cashless API secret

How it works​

  1. Customer selects "Cashless Payment" at checkout
  2. The plugin creates a bill via the Cashless API
  3. Customer is redirected to the WebPay payment page
  4. After payment, customer returns to the WooCommerce thank-you page
  5. The plugin verifies payment status and marks the order as "Processing"

Payment verification​

When the customer returns to your site, the plugin:

  1. Reads the cashless_bill_uuid from the URL
  2. Calls the Cashless API to verify the bill status
  3. If FULLY_PAID, updates the WooCommerce order to "Processing"

Troubleshooting​

Orders not marking as paid​

  • Check that your API key and secret are correct
  • Verify the Cashless server is reachable from your WordPress server
  • Check WordPress error logs for API response details

Customer not redirected back​

  • Ensure your WordPress site URL is accessible from the internet
  • Check that the WooCommerce thank-you page is configured correctly