How to Add a MoMo Payment Button to a WordPress or Shopify Site in Rwanda

The mobile money plugin ecosystem for WordPress and Shopify in Rwanda is still developing. Unlike Stripe or PayPal, which have mature, well-tested plugins for every major platform, MoMo and Airtel Money integrations are newer and fewer. Here is the realistic picture.

WordPress with WooCommerce: Some payment aggregators (check IntouchPay and Paypack) offer WooCommerce plugins that add MoMo and Airtel Money as payment options at checkout. If an aggregator you work with has a WooCommerce plugin, this is the fastest path. Install the plugin, enter your API credentials, and mobile money appears as a payment option.

Shopify: Shopify's payment gateway system is more closed than WooCommerce. Custom payment gateways on Shopify require Shopify Payments integration or the use of Shopify's alternative payment methods feature. Check whether your chosen aggregator has a Shopify app or integration. If not, options are more limited.

Other platforms (Squarespace, Wix, etc.): These platforms have even fewer mobile money integration options. For most, you would need an external checkout page or a custom solution.

WooCommerce is the most flexible option for Rwandan e-commerce because it allows custom payment gateways. Here are the paths, from easiest to most complex:

Path 1: Aggregator plugin (if available). Check if IntouchPay, Paypack, or another aggregator offers a WooCommerce plugin. If yes, install it, configure your API keys, and you are done. This is a non-developer solution that works in hours, not weeks.

Path 2: Custom WooCommerce payment gateway. If no plugin exists, a developer can build a custom WooCommerce payment gateway class in PHP. WooCommerce has a documented API for adding custom payment methods. The gateway class handles: displaying the payment option at checkout, sending the payment request to the MoMo or aggregator API, processing the callback, and updating the order status. This requires a developer with PHP experience and an understanding of the mobile money callback flow.

Path 3: External checkout redirect. Redirect the customer to a payment page hosted by your aggregator. After payment, the customer returns to your site with a success or failure indicator. This is less seamless than an integrated checkout but requires minimal WordPress customization.

If you are a developer who wants to learn to build custom payment integrations for WooCommerce and other platforms, this is a highly marketable skill in Rwanda. Many local businesses use WordPress and need mobile money payment options. The mobile money integration pattern McTaba teaches (approximately RWF 100,000) applies to any platform, including WooCommerce gateways.

Shopify does not allow custom payment gateways the way WooCommerce does. Your options are:

Option 1: Aggregator with Shopify app. Check the Shopify App Store for Rwandan mobile money payment apps, or check with your aggregator directly. If an integration exists, it is the simplest path.

Option 2: Manual payment with order instructions. Mark the order as "pending payment" and provide instructions for the customer to complete a MoMo payment to your business number. This is the low-tech approach. It works but is not automated and creates a manual verification step.

Option 3: Custom checkout via Shopify API. For developers, Shopify's Storefront API allows building a custom checkout experience where you can integrate any payment method. This is the most complex option and typically makes sense only for businesses with significant Shopify investment.

If mobile money payment integration is a core requirement and you are choosing a platform, WordPress with WooCommerce gives you significantly more flexibility than Shopify in the Rwandan market.

If you are a business owner (not a developer) reading this, here is the honest guidance:

If an aggregator plugin exists for your platform: You can probably set it up yourself. Follow the plugin documentation. If you get stuck, the aggregator's support team should be able to help.

If you need a custom integration: Hire a developer. Mobile money integrations handle real money. A bug in your payment flow means lost revenue, unhappy customers, or both. This is not a project for someone learning on the job.

What to look for in a developer for this project: experience with the MoMo or Airtel Money API, understanding of callback/webhook architecture, experience with your platform (WordPress/PHP for WooCommerce, Shopify API if applicable), and a portfolio of previous payment integrations.

Budget guidance: a custom WooCommerce MoMo/Airtel Money integration by an experienced developer in Rwanda typically takes one to three weeks and costs in the range of RWF 300,000 to 1,000,000 depending on complexity. Get quotes from multiple developers and ask to see previous payment integration work.