Set up bKash, Alif, Fawry, or MonCash

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.

bKash

**Required provider fields:** **Username**, **Password**, **App Key**, **App Secret**.

**Optional provider fields:** **Payer Reference**, **Merchant Association Info**, **Default Customer Phone**.

Use BDT and the **Username**, **Password**, **App Key**, and **App Secret** from your bKash merchant onboarding. **Payer Reference** is optional; leaving it blank uses the customer phone or order reference. **Merchant Association Info** is for aggregators or system integrators only. Do not include <, >, or & in those two fields. Leave **Custom API Base URL** blank.

Alif

**Required provider fields:** **Terminal ID**, **Terminal Password**.

**Optional provider fields:** **Payment Method**, **Default Customer Email**, **Default Customer Phone**, **Invoice Deadline Hours**.

Use TJS and your Alif acquiring **Terminal ID** and **Terminal Password**. **Payment Method** defaults to korti_milli. Other choices include wallet, salom, invoice, and supported international-card gateway options when your Alif account permits them. **Invoice Deadline Hours** applies only to invoice payments and accepts 1–720 hours. Leave **Custom API Base URL** blank for the built-in production host.

Fawry

**Required provider fields:** **Merchant Code**, **Secure Key**.

**Optional provider fields:** **Payment Method**, **Language**, **Payment Expiry Minutes**, **Default Customer Email**, **Default Customer Phone**, **Default Customer Name**, **Customer Profile ID**.

Use EGP and your **Merchant Code** and **Secure Key**. **Payment Method** can show all merchant-enabled methods or restrict to PayAtFawry, CARD, MWALLET, VALU, or CashOnDelivery. **Payment Expiry Minutes** accepts 1–10080 minutes. Only use **Customer Profile ID** when your Fawry setup requires it. PayerOne sends the callback URL, and Fawry may also require registering that same merchant-specific URL during onboarding. Leave custom API and SDK URLs blank.

MonCash

**Required provider fields:** **Client ID**, **Client Secret**.

Use HTG and the live **Client ID** and **Client Secret** from the Digicel MonCash business portal. Configure both Return URL and Alert URL using the merchant and gateway-specific callback shown in setup; including the gateway reference matters when you have more than one MonCash connection. Leave custom API and gateway URLs blank.

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.