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
- Open the Hotel Booking Payment Settings and select MoMo.
- 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.
- Enable the method and check it is offered only for an eligible VND booking and valid configuration.
- Complete a synthetic sandbox booking through the MoMo redirect and inspect both browser return and IPN processing.
- 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.
