The Simiz Laravel package provides a clean, idiomatic way to integrate mobile money payments into your Laravel application. Use the Simiz facade to create transactions, handle webhooks, and manage refunds.

Prerequisites

You need your Simiz API keys before configuring the package. Find them in Dashboard > Settings > API Keys.

Installation

1

Install the package

2

Publish the configuration

This creates a config/simiz.php configuration file.
3

Set environment variables

Add the following to your .env file:

Configuration

The published config/simiz.php file contains:

Usage

Creating a transaction

Checking transaction status

Processing refunds

Webhook handling

Register the webhook route

Add the webhook route in routes/web.php:

Create a webhook handler

Register the listener in EventServiceProvider:
The webhook signature is automatically verified by the package middleware.

Supported payment methods

Supported currencies

Webhook events

Test mode

Set the following in your .env file:
The package 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:
  • Verify SIMIZ_WEBHOOK_SECRET in your .env file
  • Ensure no middleware is modifying the raw request body before verification
  • Exclude the webhook route from CSRF protection in VerifyCsrfToken

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