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
}partnerOrderIdis 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).originalOrderIdis thepartnerOrderIdof the deposit to pay back.amountis 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_DEPOSITcan 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_REFUNDamount 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.
