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:
RequirementMinimum version
PrestaShop1.7.8
PHP8.0
Simiz accountCreate one free
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

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

SettingDescription
EnvironmentToggle 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 module automatically registers a webhook endpoint at: 
https://your-store.com/module/simizpayments/webhook
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

MethodTypeStatus
Orange MoneyMobile MoneyAvailable
MTN Mobile MoneyMobile MoneyAvailable
WaveMobile MoneyComing Soon
Moov MoneyMobile MoneyComing Soon
Airtel MoneyMobile MoneyComing Soon
M-PesaMobile MoneyComing 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 module handles webhook events automatically:
EventOrder action
transaction.createdOrder created with Awaiting payment status
transaction.processingOrder kept in Awaiting payment
transaction.completedOrder marked as Payment accepted
transaction.failedOrder marked as Payment error
transaction.cancelledOrder marked as Cancelled
transaction.expiredOrder marked as Payment error
refund.createdRefund initiated
refund.completedRefund recorded on the order
refund.failedNote added to the order

​
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

VersionDateChanges
1.0.02026-03-01Initial release — mobile money payments, webhooks, sandbox