Integrate Simiz mobile money payments into your Odoo instance (16.0, 17.0, 18.0+). This module follows Odoo’s standard payment.provider architecture for seamless integration with Odoo’s invoicing and e-commerce flows.

Prerequisites

Before you begin, make sure you have:
  • Odoo 16.0 or later (Community or Enterprise)
  • Python 3.9+
  • A Simiz account with API credentials
  • Admin access to your Odoo instance

Installation

Supported Payment Methods

Supported Currencies

Module Architecture

The module follows Odoo’s standard payment provider pattern:

Webhook Signature Verification

All webhook requests are verified using HMAC-SHA256 signatures:
  • Header: X-Simiz-Signature
  • Format: t={timestamp},v1={signature}
  • Algorithm: HMAC-SHA256 of {timestamp}.{payload} using your webhook secret
  • Tolerance: 300 seconds (5 minutes)

Test Mode

To test the integration:
  1. Set the provider state to Test Mode in Odoo
  2. Use your sandbox API key (smz_test_*)
  3. The module will automatically use the sandbox API endpoint
  4. Create a test sales order and proceed to payment
Never use production API keys in test mode. Always use your sandbox credentials (smz_test_*) for testing.

Troubleshooting

Next Steps

Webhook Events

Learn about all available webhook events and their payloads.

Sandbox Testing

Test your integration in the sandbox environment.

Go-Live Checklist

Review the checklist before going live with real payments.

API Reference

Explore the full Simiz API reference.

Changelog

Version history