Skip to main content
MoMo is a mobile wallet used by customers in Vietnam. Customers pay from their MoMo account and confirm each payment in the MoMo app or on the MoMo website. Payrails processes MoMo through dLocal as the payment service provider (PSP). Open the dLocal guide below for its setup steps and request examples.

​
How a MoMo payment works

MoMo is a redirect wallet payment method:
  1. The customer selects MoMo at checkout.
  2. Payrails returns a redirect URL from dLocal, and the customer goes to MoMo.
  3. The customer logs in and confirms the payment in the MoMo app or on the MoMo website.
  4. dLocal sends the customer back to your returnInfo URL.
  5. Payrails receives the final result from dLocal and updates the payment.
Each payment is single-use: the customer confirms every payment on its own. Payrails captures MoMo payments immediately, so a successful payment is final. To return funds, refund the payment.

​
Supported currencies and countries

MoMo supports VND (Vietnamese dong) as its only presentment currency. MoMo is available to customers based in:
RegionsCountries
Asia Pacific🇻🇳 Vietnam

​
Integrate MoMo

The dLocal guide covers the setup in dLocal and in Payrails, plus the request fields dLocal requires.

dLocal

MoMo via dLocal

​
Check PSPs

WorkflowdLocal
Payrails SDK✔
Payrails API✔
Delayed / Manual Capture✖
Instant Capture✔
Cancel / Void✖
Refund / Reverse✔
Save Instruments✖
Merchant Initiated Transaction (MIT)✖
Each MoMo payment is a new customer-initiated payment.

​
Ways to integrate MoMo

  • Payrails SDK: the Web SDK shows MoMo when your workflow returns it as a payment option, and redirects the customer to MoMo. To control how the redirect opens, listen for the actionRequired event.
  • Payrails API: call lookup payment options, then authorize with momoVN as the paymentMethodCode. The dLocal guide lists the meta fields dLocal requires.
In both cases, confirm the final result through webhook notifications or the execution status. Don’t treat the customer’s return to your success URL as proof of payment.
Last modified on October 16, 2026