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

RequirementDetails
Shopify storeAny Shopify plan
Node.js>= 18 (for custom app development)
Simiz accountCreate one free
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.
SettingDescription
EnvironmentToggle between Sandbox and Production
API KeyYour Simiz API key for the selected environment
Webhook SecretWebhook signing secret from the Simiz dashboard
Payment method titleName shown to customers at checkout (default: “Mobile Money”)
Checkout modeRedirect or Embedded checkout

​
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

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 app handles webhook events automatically:
EventOrder action
transaction.createdOrder created with Payment pending status
transaction.processingOrder kept in Payment pending
transaction.completedOrder marked as Paid
transaction.failedOrder marked as Failed
transaction.cancelledOrder marked as Cancelled
transaction.expiredOrder marked as Failed
refund.createdRefund initiated
refund.completedRefund recorded on the order
refund.failedNote added to the order
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

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