MobileWalletPartner Gateway Docs

Refunds

Paying a successful MoMo deposit back to the customer, in full or in part.

A refund sends money from your balance back to the number that paid a deposit. It is enabled like any other service: ask us to turn on MOMO_REFUND for your account.

Make a refund

POST /api/v1/momo/refund, signed like a withdrawal, since money leaves your balance:

{
  "partnerOrderId": "refund-2026-10-30-001",
  "originalOrderId": "deposit-2026-10-10-001",
  "amount": 2500
}
  • partnerOrderId is the refund's own reference. Like every order id it is unique per partner, and retrying with the same one never refunds twice (see Idempotency).
  • originalOrderId is the partnerOrderId of the deposit to pay back.
  • amount is optional. Leave it out to refund everything not yet refunded.
{
  "transactionId": "0192b7a4-6f1e-7c3a-9d2b-4e5f6a7b8c9d",
  "partnerOrderId": "refund-2026-10-30-001",
  "originalOrderId": "deposit-2026-10-10-001",
  "amount": 2500,
  "currency": "XAF",
  "status": "GW-00-PENDING",
  "failureCode": null,
  "failureMessage": null,
  "duplicate": false
}

From here a refund behaves exactly like a withdrawal: poll GET /api/v1/transactions/{partnerOrderId} with the refund's order id, or wait for its webhook. If it fails, failureCode says why (see failure codes) and nothing moved, so you can refund again.

Rules

  • Only a successful MOMO_DEPOSIT can be refunded, with a credential of the same environment (a Sandbox deposit with a Sandbox credential, a Live one with a Live credential).
  • The money goes back to the number that paid. You can't choose another number.
  • Refunds of one deposit never add up to more than the deposit. Only successful refunds count, so a failed refund leaves its amount refundable.
  • One refund at a time. While a refund of a deposit is pending, another refund of the same deposit is refused with 400. Wait for its final status first.
  • Your balance must cover the refund, and your MOMO_REFUND amount and daily limits apply.
  • A refund is a payout: it is debited from your balance like a withdrawal (see Partner ledger).

From the dashboard

On a successful deposit's page in the partner dashboard, a PartnerAdmin can refund it with the Refund button. It asks for your password and an authenticator code. The page lists every refund of the deposit and how much can still be refunded.