Set up PawaPay or Fapshi mobile-money payments

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.

PawaPay

**Required provider fields:** **Country**, **API Token**.

**Optional provider fields:** **Language**, **Customer Message**, **Amount Decimals**.

Select a **Country** and matching **Processing Currency** offered in the form and enabled on your PawaPay account. The country selector uses three-letter country codes. Enter a live **API Token**. **Language** supports EN or FR. **Customer Message** accepts 4–22 letters, numbers, or spaces. **Amount Decimals** accepts 0–4 and defaults to 2; use 0 for a provider that requires whole amounts. Register the Deposit callback URL shown in setup in the live PawaPay dashboard.

Fapshi

**Required provider fields:** **API User**, **API Key**, **Webhook Secret**.

This integration is Fapshi hosted collection checkout for Cameroon MTN Mobile Money and Orange Money. Select XAF, enter **API User** and **API Key**, and set the same **Webhook Secret** in PayerOne and the Fapshi collection service. Register the merchant-specific webhook URL shown in the gateway description. Amounts are sent as whole XAF with a minimum of 100 XAF. This setup does not provide Direct Pay, payouts, or gateway refunds.

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.