The Simiz WooCommerce plugin lets you accept mobile money payments directly in your online store. Customers pay via Orange Money, MTN MoMo, and other mobile wallets — with automatic order updates through webhooks.

​
Prerequisites

Before installing, make sure your environment meets these requirements:
You need your Simiz API keys before configuring the plugin. Find them in Dashboard → Settings → API Keys.

​
Installation

1

Download the plugin

Download the Simiz for WooCommerce plugin from WordPress.org or directly from your Simiz dashboard.You’ll receive a .zip file named simiz-woocommerce.zip.
2

Upload and activate

  1. Go to your WordPress admin panel
  2. Navigate to Plugins → Add New → Upload Plugin
  3. Select the simiz-woocommerce.zip file and click Install Now
  4. Click Activate Plugin
You can also install via FTP by uploading the extracted simiz-woocommerce folder to /wp-content/plugins/.
3

Configure the plugin

  1. Go to WooCommerce → Settings → Payments
  2. Find Simiz Payments and click Manage
  3. Enter your API key and webhook secret
  4. Save your settings
The plugin is now ready to accept payments.

​
Configuration

Navigate to WooCommerce → Settings → Payments → Simiz Payments to access all settings.

​
General settings

​
API credentials

The plugin uses separate credentials for test and live environments:
Never share your API keys publicly. Store them securely and never commit them to version control.

​
Webhook URL

The plugin automatically registers a webhook endpoint at:
Copy this URL into your Simiz dashboard under Settings → Webhooks to receive payment notifications.

​
Payment flow

Here’s how a payment works end-to-end:
1

Customer checks out

The customer selects Mobile Money as the payment method and chooses their mobile money provider (Orange Money, MTN MoMo, etc.).
2

Payment is initiated

The plugin sends a request to the Simiz API to create a transaction. The customer is redirected to the Simiz checkout page or receives a mobile money prompt on their phone.
3

Customer confirms payment

The customer confirms the payment on their phone by entering their mobile money PIN.
4

Webhook confirms the order

Simiz sends a transaction.completed webhook to your store. The plugin verifies the signature, updates the order status to Processing, and sends the confirmation email to the customer.

​
Supported payment methods

The plugin exposes the Simiz API Mobile Money methods across the CEMAC and UEMOA zones (14 countries). Corridors are being activated (Coming soon): live coverage is at /coverage and actual availability per account is in the dashboard.

Orange Money

ORANGE_MONEY

MTN Mobile Money

MTN_MOMO
More payment methods are added as licensed partners are activated.

​
Supported currencies

​
Webhooks

The plugin handles webhook events automatically. When Simiz sends a notification, the plugin:
  1. Verifies the HMAC-SHA256 signature using your webhook secret
  2. Parses the event to determine the transaction status
  3. Updates the WooCommerce order accordingly

​
Webhook events

You can test webhook delivery from your Simiz dashboard under Settings → Webhooks → Send Test Event.

​
Test mode

The plugin supports full sandbox testing so you can verify your integration before going live.

​
Switching modes

  1. Go to WooCommerce → Settings → Payments → Simiz Payments
  2. Check or uncheck the Test Mode checkbox
  3. Save changes
When test mode is enabled, the plugin uses your sandbox API key and no real money is charged.

​
Sandbox test numbers

Use these numbers to simulate different payment outcomes:

Full sandbox documentation

See all test numbers and scenarios in the Sandbox Testing guide.

​
Refunds

The plugin supports full and partial refunds from the WooCommerce admin:
  1. Open the order in WooCommerce → Orders
  2. Click Refund
  3. Enter the refund amount (full or partial)
  4. Click Refund via Simiz
The refund is processed through the Simiz API and the order is updated automatically.

​
WooCommerce Blocks compatibility

The plugin is compatible with the WooCommerce Blocks checkout. No additional configuration is needed — the Simiz payment method appears automatically in both the classic and block-based checkout.

​
Troubleshooting

Symptoms: Order stays in “Pending” status after the customer pays.Solutions:
  • Verify your webhook URL is correctly configured in the Simiz dashboard
  • Check that your webhook secret matches between WooCommerce and Simiz
  • Ensure your server allows incoming POST requests to the webhook endpoint
  • Check your WordPress error log at wp-content/debug.log

​
FAQ

Yes. You need a Simiz account to get your API keys. Creating an account is free.

​
Next steps

Sandbox Testing

Test all payment scenarios before going live.

Webhook Verification

Learn about webhook signature verification.

API Reference

Explore the full Simiz API.

Support

Need help? Contact our support team.

​
Changelog

Version history