Black Friday
Skip to documentation content

Pricing, Payments & Tax

Configure native MoMo payments

MoMo is a Pro online-payment provider for VND bookings. Its redirect and signed return/IPN processing are distinct from Stripe, PayPal and WooCommerce checkout; enabling another provider does not configure MoMo.

MoMo is a Pro online-payment provider for VND bookings. Its redirect and signed return/IPN processing are distinct from Stripe, PayPal and WooCommerce checkout; enabling another provider does not configure MoMo.

Prepare the environment

Use compatible Free and entitled Pro, an authorized payment-settings account, and credentials for the intended MoMo environment. Native MoMo requires public HTTPS return and IPN endpoints; a private wp.local URL is not a provider-reachable callback.

The current adapter supports whole-number totals from 1,000 to 50,000,000 VND. A fractional or out-of-range booking can be rejected even when the room price looked valid. Include discounts, services and taxes when testing the final payable amount; do not round the stored booking total manually to bypass validation.

Configure and test

  1. Open the Hotel Booking Payment Settings and select MoMo.
  2. Choose Sandbox first and save the matching Partner Code, Access Key and Secret Key. Copy return/IPN URLs from the actual installation’s settings where supplied.
  3. Enable the method and check it is offered only for an eligible VND booking and valid configuration.
  4. Complete a synthetic sandbox booking through the MoMo redirect and inspect both browser return and IPN processing.
  5. Compare the verified amount, currency, payment reference and booking ledger. Also test cancellation and an unsuccessful/late return.

The plugin verifies callback signatures and transaction identity. Browser query text or a success page alone does not establish payment. Keep credentials and complete signed callback payloads out of public logs and support screenshots.

Refund and recovery boundary

The current Hotel Booking gateway-operation set does not include a native MoMo refund-execution adapter. Do not infer refund support from successful MoMo collection. Use the provider’s authorized external procedure, then the supported verified manual/reconciliation path as applicable; a manual record itself sends no money.

If payment remains pending, preserve the existing booking/attempt and inspect callback reachability, environment, credentials and verification errors before asking the customer to pay again. A late verified payment can require staff review on a closed booking. See payment recovery.

Was this article helpful?

Your feedback helps us improve the documentation.