The Simiz Shopify app lets you accept mobile money payments directly in your Shopify 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 app. Find them in Dashboard > Settings > API Keys.

​
Installation

1

Install from Shopify App Store

  1. Visit the Simiz Payments app on the Shopify App Store
  2. Click Add app
  3. Review the required permissions and click Install app
2

Connect your Simiz account

  1. After installation, you will be redirected to the Simiz configuration page
  2. Enter your Simiz API key (smz_test_* for sandbox, smz_live_* for production)
  3. Enter your webhook secret
  4. Click Save
3

Activate the payment method

  1. Go to Settings > Payments in your Shopify admin
  2. Find Simiz Payments under Additional payment methods
  3. Click Activate
The app is now ready to accept payments at checkout.

​
Configuration

​
App settings

Access settings from Apps > Simiz Payments in your Shopify admin.

​
Checkout extension

The app integrates with Shopify’s checkout extensibility framework. It adds a payment option that appears alongside other payment methods during checkout. No additional theme modifications are required. The payment method renders automatically in both classic and checkout extensibility themes.

​
Payment flow

1

Customer checks out

The customer selects Mobile Money as the payment method during Shopify checkout.
2

Payment is initiated

The app creates a transaction via the Simiz API. The customer is redirected to the Simiz checkout page to enter their phone number and select their provider.
3

Customer confirms payment

The customer receives a prompt on their phone and confirms the payment with their mobile money PIN.
4

Order is confirmed

Simiz sends a transaction.completed webhook. The app verifies the signature, marks the Shopify order as Paid, and the customer sees the order confirmation page.

​
Supported payment methods

​
Supported currencies

​
Webhooks

The app handles webhook events automatically:
Webhook URLs are automatically configured during app installation. No manual setup is required.

​
Test mode

  1. Open the Simiz app in your Shopify admin
  2. Set the environment to Sandbox
  3. Enter your sandbox API key (smz_test_*)
  4. Save changes
The app 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 “Payment pending” after the customer pays.Solutions:
  • Verify the app is properly connected to your Simiz account
  • Check that your webhook secret is correct
  • Review webhook delivery logs in the Simiz dashboard

​
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