The Simiz Drupal Commerce module 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

You need your Simiz API keys before configuring the module. Find them in Dashboard > Settings > API Keys.

​
Installation

1

Install via Composer

2

Enable the module

Or enable it through the admin UI at Extend and check Simiz Payment.
3

Configure the payment gateway

  1. Go to Commerce > Configuration > Payment gateways
  2. Click Add payment gateway
  3. Select Simiz Payments as the plugin
  4. Enter your API key and webhook secret
  5. Select the mode (Test or Live)
  6. Save

​
Configuration

​
Payment gateway settings

​
Webhook URL

The module registers a webhook endpoint at:
Copy this URL into your Simiz dashboard under Settings > Webhooks.

​
Payment flow

1

Customer checks out

The customer selects Mobile Money at checkout and chooses their provider.
2

Payment is initiated

The module creates a transaction via the Simiz API. The customer is redirected to the Simiz checkout page.
3

Customer confirms payment

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

Webhook confirms the order

Simiz sends a transaction.completed webhook. The module verifies the signature and completes the order.

​
Supported payment methods

​
Supported currencies

​
Webhooks

​
Test mode

  1. Go to Commerce > Configuration > Payment gateways
  2. Edit your Simiz gateway and set the mode to Test
  3. Enter your sandbox API key (smz_test_*)
  4. Save
The module connects to sandbox.api.simiz.io and no real money is charged.

Full sandbox documentation

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

​
Troubleshooting

Solutions:
  • Verify your webhook URL in the Simiz dashboard
  • Check that your webhook secret matches
  • Ensure your server allows incoming POST requests
  • Check Drupal logs at Reports > Recent log messages

​
Next steps

Webhook Verification

Learn about webhook configuration and signature verification.

API Reference

Explore the full Simiz API.

Sandbox Testing

Test all payment scenarios before going live.

Support

Need help? Contact our support team.

​
Changelog

Version history