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:
RequirementMinimum version
WordPress6.0
WooCommerce7.0
PHP8.1
Simiz accountCreate one free
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

SettingDescription
Enable/DisableToggle Simiz as a payment method at checkout
TitlePayment method name shown to customers (default: “Mobile Money”)
DescriptionDescription shown during checkout

​
API credentials

The plugin uses separate credentials for test and live environments:
SettingDescription
Test ModeToggle between sandbox and production
Test API KeyYour sandbox key (smz_test_xxxxxxxxxxxx)
Test Webhook SecretSandbox webhook signing secret
Live API KeyYour production key (smz_live_xxxxxxxxxxxx)
Live Webhook SecretProduction webhook signing secret
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: 
https://your-store.com/?wc-api=simiz_webhook
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

Orange Money

Cameroon, Senegal, Ivory Coast, Mali, Burkina Faso, Niger, Guinea, Congo, DR Congo, Madagascar

MTN Mobile Money

Cameroon, Ivory Coast, Ghana, Uganda, Rwanda, Zambia, Benin, Congo
More payment methods (Wave, Moov Money, Airtel Money, M-Pesa) are coming soon.

​
Supported currencies

CurrencyCodeCountries
Central African CFA FrancXAFCameroon, Central African Republic, Chad, Congo, Equatorial Guinea, Gabon
West African CFA FrancXOFBenin, Burkina Faso, Ivory Coast, Guinea-Bissau, Mali, Niger, Senegal, Togo
Ghanaian CediGHSGhana
Nigerian NairaNGNNigeria
Kenyan ShillingKESKenya
Ugandan ShillingUGXUganda
Rwandan FrancRWFRwanda
Tanzanian ShillingTZSTanzania

​
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

EventOrder action
transaction.completedOrder marked as Processing
transaction.failedOrder marked as Failed
transaction.cancelledOrder marked as Cancelled
transaction.expiredOrder marked as Failed
refund.completedRefund recorded on the order
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:
NumberOperatorResult
237690000001Orange MoneySuccess
237670000001MTN MoMoSuccess
237690000002Orange MoneyInsufficient balance
237690000003Orange MoneyTimeout

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

VersionDateChanges
1.0.02026-03-01Initial release — Orange Money, MTN MoMo, webhooks, sandbox