The Simiz PrestaShop 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

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

​
Installation

1

Download the module

Download the Simiz for PrestaShop module from your Simiz dashboard.You’ll receive a .zip file named simiz-prestashop.zip.
2

Upload and install

  1. Go to your PrestaShop back office
  2. Navigate to Modules > Module Manager > Upload a module
  3. Select the simiz-prestashop.zip file
  4. The module is automatically installed after upload
You can also install manually by extracting the module to /modules/simizpayments/ via FTP.
3

Configure the module

  1. Go to Modules > Module Manager
  2. Find Simiz Payments and click Configure
  3. Enter your API key and webhook secret
  4. Select your environment (Sandbox or Production)
  5. Save your settings
The module is now ready to accept payments.

​
Configuration

Navigate to Modules > Module Manager > Simiz Payments > Configure to access all settings.

​
General settings

​
API credentials

Never share your API keys publicly. Store them securely and never commit them to version control.

​
Webhook URL

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

​
Payment flow

1

Customer checks out

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

Payment is initiated

The module sends a request to the Simiz API to create a transaction. The customer is redirected to the Simiz checkout page or receives a prompt on their phone.
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 to your store. The module verifies the signature, updates the order status to Payment accepted, and sends the confirmation email.

​
Supported payment methods

​
Supported currencies

​
Webhooks

The module handles webhook events automatically:

​
Test mode

  1. Go to Modules > Module Manager > Simiz Payments > Configure
  2. Set the environment to Sandbox
  3. Enter your sandbox API key (smz_test_*)
  4. Save changes
When sandbox mode is enabled, 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

Symptoms: Order stays in “Awaiting payment” after the customer pays.Solutions:
  • Verify your webhook URL is correctly configured in the Simiz dashboard
  • Check that your webhook secret matches between PrestaShop and Simiz
  • Ensure your server allows incoming POST requests to the webhook endpoint
  • Check PrestaShop logs in Advanced Parameters > Logs

​
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