Connect the MoMo wallet

Enter your MoMo merchant details so customers can pay with their MoMo wallet. After they click Đặt hàng, customers are sent to the MoMo page to pay. When MoMo confirms, the order changes to Paid automatically.

You need the Partner Code, Access Key and Secret Key from your store's MoMo admin page.

Add MoMo

1. Go to Settings › Payment methods.
2. Click Add method at the bottom of the list.
3. On the MoMo row, click Add.
4. Edit the Display name if you want, for example MoMo wallet. Customers see this name when they choose how to pay.
5. Enter a Description if you want one. The description appears when the customer selects MoMo.

On a phone, click the menu icon at the top left, select Settings, then click the list icon next to Settings to choose Payment methods.

Enter your MoMo details

Staying on the same page, scroll down to the Gateway credentials card. The card says Not configured.

1. Enter the Partner Code.
2. Enter the Access Key.
3. Enter the Secret Key.
4. Leave Endpoint (optional) empty. EcomWeb uses the MoMo address for the mode you choose.
5. Keep Sandbox selected under Mode. It is selected by default.
6. Click Configure.

The card changes to Configured, along with the mode you chose.

Turn on MoMo and save

A new payment gateway method is always turned off. The switch can only be turned on after you have clicked Configure.

1. On the Status card, turn on Activate.
2. Click Save on the save bar at the bottom of the page.

The method you just added may sit at the top of the list, and customers will see it selected by default. To move it, see Reorder payment methods.

Try a payment

1. Place a test order and choose MoMo under Payment method. To place one, see Place a test order.
2. Click Đặt hàng, the button that places the order.
3. Pay on the MoMo page that opens.
4. Wait for the store to report a successful payment.
5. In the dashboard, open the order under Orders.
6. Check that the Payment card says Paid and shows a Transaction ID.

Switch to live mode

When you save again, all the old details are replaced, so you must enter every field again.

1. Go to Settings › Payment methods.
2. Click the name of the MoMo method.
3. On the Gateway credentials card, click Replace.
4. Enter the Partner Code of your real account.
5. Enter the Access Key of your real account.
6. Enter the Secret Key of your real account.
7. Under Mode, choose Live.
8. Click Configure.
9. Place a small order with real money, then check that the order’s Payment card says Paid before you open for sales.

In the list of methods, the MoMo row shows a red Live tag. From now on, customers pay real money.

Stop accepting MoMo

1. Go to Settings › Payment methods.
2. Click the Activate switch on the MoMo row to turn it off.

Customers no longer see MoMo at checkout. The credentials are kept, so you can turn it back on at any time.

Frequently asked questions