Set up BaoKim, VNPAY, MoMo, or ZaloPay

Open **Payments → Payment Gateways → Add Gateway**, select the provider, and choose **Continue**. Enter **Name**, select **Processing Currency**, and complete that provider's required fields below. Use credentials from the same live merchant account and keep secret values private. After reviewing optional settings and **Limits**, choose **Save Gateway**.

Leave provider sandbox or try-environment switches off. Leave optional custom endpoint and SDK URL fields blank to use the built-in integration. The currency and methods must also be enabled by the provider on your merchant account. Common optional fees, **Custom Exchange Rate (1 USD)**, **Mask Description** where present, and **Disable** are described in the gateway setup guides.

BaoKim

**Required provider fields:** **Merchant ID**, **API Key**, **API Secret**.

**Optional provider fields:** **Payment Method**, **Custom BPM ID**, **Language**, **Default Customer Email**, **Default Customer Phone**.

Select VND. **Payment Method** can open the BaoKim selector or choose a supported method. **Custom BPM ID** overrides that choice when filled; leave it blank unless BaoKim has given you the intended BPM ID. The named method mappings are vietqr=295, atm=15, account_number=344, credit_card=128, and vnpay_qr=297. Use the callback details shown in the gateway configuration.

VNPAY

**Required provider fields:** **TmnCode**, **Hash Secret**.

**Optional provider fields:** **Payment Method**, **Locale**, **Order Type**, **Expiry Minutes**.

Select VND and use the merchant website **TmnCode** and **Hash Secret**. Leave **Payment Method** empty to let the customer choose, or use VNPAYQR, VNBANK, or INTCARD where enabled. **Order Type** defaults to other. **Expiry Minutes** defaults to 15. Register the merchant-specific VNPAY IPN URL shown by the gateway setup in the VNPAY portal.

MoMo

**Required provider fields:** **Partner Code**, **Access Key**, **Secret Key**.

**Optional provider fields:** **Request Type**, **Language**, **Partner Name**, **Store ID**, **Store Name**, **Extra Data**.

Select VND and use the **Partner Code**, **Access Key**, and **Secret Key** for your live MoMo integration. **Request Type** defaults to captureWallet. payWithATM and payWithCC require at least 10000 VND. Leave **Extra Data** blank unless MoMo requires a base64 payload. Optional partner/store fields describe your MoMo merchant setup.

ZaloPay

**Required provider fields:** **App ID**, **Key 1**, **Key 2**.

**Optional provider fields:** **Payment Method**, **Custom Bank Code**, **App User**.

Select VND. **Key 1** signs order requests and **Key 2** verifies callback data; keep them in the correct fields. **Payment Method** supports the method selector, ZaloPay app, cards, or ATM/bank methods as enabled. **Custom Bank Code** overrides that choice when filled. Leave it blank unless you need a specific supported bank code. Use the callback details shown in setup.

Check a new connection

Use a fresh checkout to confirm the expected provider name, processing currency, and total. If saving fails, recheck the required fields, live-account credentials, and currency selection. If the provider records a payment but the order does not update, keep the provider reference and order reference and ask support to review them before asking the customer to pay again. Never include secret values in that request.