Setting Up Payment Processors

Payment processors let your customers pay for orders electronically. Configure them in Settings > Payment Processors.

Note: Only organization admins can manage payment processor settings.

Accessing Payment Settings

  1. Go to Settings in the sidebar
  2. Scroll down to the Payment Processors card
Payment processors section in settings

Available Payment Processors

ProcessorStatusDescription
Test PaymentAvailableA sandbox payment provider for testing
MomoPayAvailableVietnam’s popular mobile payment platform
VNPayComing SoonVietnam’s bank-linked payment gateway

Test Payment Provider

The test payment provider simulates payment flows without processing real money. Use it during setup and testing.

To enable/disable:

Toggle the switch next to Test Payment Provider. When enabled, test payment options appear in the order flow.

Test payment toggle switch

Warning: Disable test payments before going live to prevent fake transactions.


Setting Up MomoPay

MomoPay is a popular mobile wallet in Vietnam. To configure it:

  1. Click the MomoPay card to expand it
  2. Enter your MomoPay credentials:
FieldDescription
Partner CodeYour MomoPay merchant partner code
Access KeyAPI access key from your MomoPay merchant dashboard
Secret KeyAPI secret key — keep this confidential
  1. Sandbox Mode — Toggle this on to use MomoPay’s test environment. Toggle off for live payments.
  2. Click Save
MomoPay configuration form

Getting MomoPay Credentials

  1. Sign up for a MomoPay Business account at the MomoPay merchant portal
  2. Complete the merchant verification process
  3. Navigate to your merchant dashboard
  4. Find your Partner Code, Access Key, and Secret Key under API settings
MomoPay merchant dashboard (example)

Testing MomoPay

Before going live:

  1. Enable Sandbox Mode in the MomoPay card
  2. Enter your sandbox credentials (provided by MomoPay)
  3. Create a test order and attempt payment
  4. Verify the payment flow works correctly
  5. Disable Sandbox Mode and enter your production credentials

VNPay (Coming Soon)

VNPay integration is planned for a future release. The card appears in the settings with a “Coming Soon” badge.

VNPay coming soon placeholder

Tips

  • Always test payment flows in sandbox mode before going live
  • Keep your API secret keys confidential — never share them
  • Enable only the payment methods you actively support
  • Disable the test payment provider in production
  • If payments fail, check that your credentials are correct and your merchant account is active