MTN MoMo for WooCommerce

Accept MTN Mobile Money payments on your WooCommerce store. Customers enter their MoMo number at checkout, receive a USSD prompt on their phone, approve — and the order is automatically confirmed.

How It Works

Customer enters MoMo number at checkout
        ↓
Plugin calls MTN Collection API (Request to Pay)
        ↓
Customer receives USSD prompt on their phone
        ↓
Customer approves with their PIN
        ↓
Order automatically confirmed on your website

Features

• ✅ MTN MoMo Collection API v1 (Request to Pay via USSD)
• ✅ Sandbox & Production environments
• ✅ Real-time confirmation via webhook callback
• ✅ Frontend polling on order-received page
• ✅ WP-Cron fallback status check
• ✅ One-click sandbox credential generator
• ✅ PHP 8.2 compatible
• ✅ Rwanda (RWF), Ghana (GHS), Uganda (UGX), Zambia (ZMW)

Requirements

Installation

1. Download the latest ZIP from Releases
2. WordPress → Plugins → Add New → Upload Plugin
3. Activate the plugin
4. Go to WooCommerce → Settings → Payments → MTN Mobile Money

Getting Your API Credentials (Rwanda)

Sandbox (Testing)

1. Register at momodeveloper.mtn.co.rw
2. Subscribe to the Collections product
3. Copy your Primary Key
4. In plugin settings: paste Primary Key → Save → click "Generate Sandbox API User & Key"

Production (Live)

1. Go to momodeveloper.mtn.co.rw/go-live
2. Submit your KYC business documents
3. MTN approves and gives you production credentials
4. Switch plugin Environment to Production

Plugin Settings

Sandbox Testing

In sandbox mode, no real money moves and no USSD is sent to your phone.

Project Structure

mtn-momo-woocommerce/
├── .github/
│   └── workflows/
│       └── ci.yml                  # GitHub Actions CI
├── assets/
│   ├── css/checkout.css            # Checkout styling
│   ├── js/checkout.js              # Frontend polling
│   └── images/                     # Add mtn-momo-logo.png here
├── includes/
│   ├── class-mtn-momo-api.php      # MTN API client
│   ├── class-mtn-momo-gateway.php  # WooCommerce gateway
│   └── class-mtn-momo-webhook.php  # Callback handler
├── mtn-momo-woocommerce.php        # Plugin bootstrap
├── CHANGELOG.md
├── CONTRIBUTING.md
└── README.md

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

GPL-2.0 — see LICENSE file.

Support

• Open a GitHub Issue for bugs
• Check WooCommerce → Status → Logs → mtn-momo for error logs