Back to Home

API Reference

Complete reference for the MoMo Gateway REST API. All authenticated endpoints require x-app-id and x-secret-key headers.

Base URLhttps://momo.mellow.africa

1Tenants Engine

2Payments Engine

Setting Up Your Webhook Listener

After initiating a charge, the payment flows asynchronously. When the payment is confirmed, the gateway dispatches a transaction.updated event to your registered webhook_url.

  1. 1.Register a public HTTPS endpoint on your server (e.g. https://your-api.com/webhooks/payments)
  2. 2.Provide that URL in the webhook_url field when registering your business on our portal
  3. 3.Your endpoint receives a POST with event: "transaction.updated" — fulfill orders on status: "SUCCESSFUL"
  4. 4.Always return HTTP 200 to acknowledge receipt