The Simiz WordPress plugin lets you accept mobile money payments on any WordPress site without WooCommerce. Use shortcodes to embed payment forms or the REST API for custom AJAX-based payment flows.

​
Prerequisites

RequirementMinimum version
WordPress6.0
PHP8.1
Simiz accountCreate one free
This plugin is for WordPress sites without WooCommerce. If you use WooCommerce, see the WooCommerce integration instead.

​
Installation

1

Download the plugin

Download the Simiz for WordPress plugin from your Simiz dashboard.You’ll receive a .zip file named simiz-wordpress.zip.
2

Upload and activate

  1. Go to your WordPress admin panel
  2. Navigate to Plugins > Add New > Upload Plugin
  3. Select the simiz-wordpress.zip file and click Install Now
  4. Click Activate Plugin
3

Configure the plugin

  1. Go to Settings > Simiz Payments
  2. Enter your API key and webhook secret
  3. Select your environment (Sandbox or Production)
  4. Save your settings

​
Configuration

Navigate to Settings > Simiz Payments in your WordPress admin.
SettingDescription
EnvironmentSandbox or Production
API KeyYour Simiz API key for the selected environment
Webhook SecretWebhook signing secret from the Simiz dashboard
Success URLPage to redirect to after successful payment
Cancel URLPage to redirect to after cancelled payment

​
Webhook URL

The plugin registers a webhook endpoint at: 
https://your-site.com/wp-json/simiz/v1/webhook
Copy this URL into your Simiz dashboard under Settings > Webhooks.

​
Shortcode usage

Embed a payment button or form anywhere on your site using the [simiz_payment] shortcode.

​
Basic usage

[simiz_payment amount="5000" currency="XAF"]

​
Full parameters

ParameterDescriptionDefault
amountPayment amount in the smallest currency unitRequired
currencyCurrency code (XAF, XOF, etc.)Store default
descriptionPayment description”Payment”
button_textText displayed on the pay button”Pay Now”
success_urlRedirect URL after successPlugin default
cancel_urlRedirect URL after cancelPlugin default
classCSS class for the buttonsimiz-pay-button

​
Examples

[simiz_payment amount="10000" currency="XAF" description="Event ticket" button_text="Buy Ticket"]

[simiz_payment amount="25000" currency="XOF" description="Consultation fee"]

​
REST API

For custom AJAX-based payments, the plugin exposes a REST endpoint: 
POST /wp-json/simiz/v1/create-payment

​
Request body

{
  "amount": 5000,
  "currency": "XAF",
  "description": "Custom payment",
  "customer_email": "customer@example.com",
  "metadata": {
    "order_id": "12345"
  }
}

​
Response

{
  "transaction_id": "txn_xxxxxxxxxxxx",
  "checkout_url": "https://checkout.simiz.io/txn_xxxxxxxxxxxx",
  "status": "created"
}

​
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

EventAction
transaction.createdPayment recorded as Pending
transaction.processingPayment status updated to Processing
transaction.completedPayment marked as Completed, success callback triggered
transaction.failedPayment marked as Failed
transaction.cancelledPayment marked as Cancelled
transaction.expiredPayment marked as Expired
refund.createdRefund initiated
refund.completedRefund recorded
refund.failedRefund failure logged

​
Test mode

  1. Go to Settings > Simiz Payments
  2. Set the environment to Sandbox
  3. Enter your sandbox API key (smz_test_*)
  4. Save changes
The plugin 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:
  • Ensure the plugin is activated
  • Check that the shortcode parameters are valid
  • Verify there are no JavaScript errors on the page
  • Clear your WordPress cache

​
Next steps

WooCommerce Integration

Need e-commerce? Use the WooCommerce plugin instead.

Webhook Verification

Learn about webhook configuration and signature verification.

API Reference

Explore the full Simiz API.

Support

Need help? Contact our support team.

​
Changelog

Version history

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