EasyMoPay
EasyMoPay Documentation

Guides for merchants, operators, and future API developers.

Browse documentation
Plugin guide

WooCommerce plugin

Install the EasyMoPay payment plugin and prepare a WooCommerce store for supported mobile money methods.

Plugin availability

The EasyMoPay dashboard advertises WooCommerce plugin version 2.4.1 and includes installation instructions. The plugin package and PHP source are not part of this repository, and the current download button is not connected to a file.

Obtain the verified package first

Request the official ZIP from EasyMoPay support. Do not install a package from an unverified third party. Exact plugin fields and payment-method toggles cannot be documented until the published package is available for inspection.

Requirements

  • An approved EasyMoPay merchant account.
  • A WordPress site with WooCommerce installed and activated.
  • Permission to install plugins and edit WooCommerce payment settings.
  • An EasyMoPay WooCommerce store record and at least one configured gateway.
  • The official EasyMoPay plugin ZIP supplied through an authorized channel.

Download, install, and activate

  1. 1Obtain the official plugin ZIP from EasyMoPay support.
  2. 2In WordPress, open Plugins → Add New → Upload Plugin.
  3. 3Select the ZIP, choose Install Now, and wait for WordPress to complete installation.
  4. 4Choose Activate Plugin.
  5. 5Open WooCommerce → Settings → Payments → EasyMoPay.

Connect the store to EasyMoPay

  1. 1In EasyMoPay, open Stores and create a store with the WooCommerce platform.
  2. 2Open Payment Gateways, configure a provider, run Test Connection, and save only after the test succeeds.
  3. 3In the plugin settings, enter only the EasyMoPay connection values supplied by the dashboard or official support.
  4. 4Save the WooCommerce settings, then reload the page and confirm EasyMoPay remains enabled.

Connection value visibility

Store records receive a unique token internally, but the current Stores screen does not display it. If your plugin asks for a token that is not visible, contact support rather than substituting a gateway secret.

Configure payment methods

The application supports Wave, Orange Money, and M-Pesa credentials. A method can process payments only when its corresponding EasyMoPay gateway credential is active.

  1. 1Configure the required provider in EasyMoPay before enabling its method in WooCommerce.
  2. 2Use the plugin controls to enable only methods shown by the installed, official plugin.
  3. 3Save changes and verify the methods at checkout with a test product.
  4. 4Do not assume the plugin has controls that are not visible in your installed version.

Test the integration

  1. 1Use provider-issued sandbox credentials where the provider offers them.
  2. 2Run Test Connection in EasyMoPay and save the verified credential set.
  3. 3Place a small test order in WooCommerce and select EasyMoPay at checkout.
  4. 4Complete or deliberately cancel the provider flow.
  5. 5Confirm the result in EasyMoPay Transactions and in the WooCommerce order notes/status.

Test all three outcomes

Exercise successful, failed or cancelled, and pending flows before launch. Provider callbacks can be asynchronous, so allow time for a pending payment to update.

Production activation

  1. 1Obtain production credentials directly from each payment provider.
  2. 2Replace sandbox credentials in Payment Gateways and run Test Connection again.
  3. 3Save the production credentials and verify that the gateway shows Connected.
  4. 4Make one controlled live transaction and confirm its final state in both systems.
  5. 5Never paste provider secrets into support tickets, screenshots, or source control.

Plugin updates

No automatic update channel is implemented in the application repository. Obtain each signed or verified release from EasyMoPay, back up WordPress, test the update on staging, then update production through WordPress plugin administration.

Version-specific behavior

Keep the currently installed plugin ZIP until the replacement is verified. Settings and migration behavior must be checked against the release notes supplied with the package.

Common configuration problems

  • EasyMoPay is absent from checkout: confirm the plugin and WooCommerce payment method are active and the cart meets any rules shown by the plugin.
  • Connection is rejected: confirm the EasyMoPay account is approved, the store exists, and no provider credential was pasted into a store-token field.
  • A method is missing: configure and test the matching gateway in EasyMoPay, then review the plugin's visible method controls.
  • Callbacks do not update orders: verify HTTPS, caching/security plugins, and that the WordPress REST API is reachable.
  • Download or token is unavailable: this is a current dashboard limitation; contact EasyMoPay support.