AmwalPay

Connect AmwalPay to PayLexer to accept card payments and digital payment methods in Omani Rial across Oman and the wider GCC region.

AmwalPay is an Omani payment infrastructure and gateway provider built for the Sultanate of Oman's digital economy. It enables businesses to accept online and in-store payments via major card schemes and supported digital payment methods.

While primarily focused on Oman, AmwalPay operates within the broader GCC payments ecosystem (Gulf Cooperation Council, comprising Saudi Arabia, United Arab Emirates, Kuwait, Qatar, Bahrain, and Oman) and is positioned for regional expansion as cross-border payment infrastructure across the Gulf continues to evolve.

Supported Regions (Merchant Accounts): Sultanate of Oman, with participation in the wider GCC payments ecosystem
Supported Currencies: OMR (Omani Rial) and multi-currency acceptance via international card networks and available digital payment methods

This gateway appears in checkout only when the selected currency is OMR.

Supported Features

One-time payments
Refunds
Payment status updates

Feature availability depends on your merchant configuration with AmwalPay.

Before You Start

Make sure you have:

AmwalPay Merchant Account – Don't have one? Contact AmwalPay to create a merchant account →
PayLexer Account – Required to configure the integration. Create your account →
A website where you want to integrate

Looking for a different payment processor? View all supported gateways →

Configuring AmwalPay

You need a Merchant ID, Terminal ID, and Secret Key from AmwalPay for this integration.

Getting API Credentials

AmwalPay credentials are issued directly by AmwalPay support and are not available for self-service download.

Contact AmwalPay Support

Reach out to AmwalPay support through your Merchant Dashboard, by email at support@amwalpay.om, or by phone at +968 24121845.

Request your API credentials

Request Test and Live API credentials from the support team. They will issue your:

Terminal ID
Secret Key

Credentials must be requested from AmwalPay support — they cannot be generated from the dashboard. Processing time varies depending on their support team.

Adding Credentials to PayLexer

Open PayLexer Dashboard

Enter your credentials

Paste the Merchant ID, Terminal ID, and Secret Key you received from AmwalPay.

Understanding Live/Production and Sandbox Settings:

Environment	Purpose
Live / Production (Mandatory)	Used for real transactions. Cannot be empty, even when testing.
Test / Sandbox (Optional)	Used for testing only. No real money is processed.

How PayLexer selects credentials:

Debug/Test mode ON → Test credentials are used
Debug/Test mode OFF → Live credentials are used

You do not need to manually switch keys once both environments are saved.

Test and save

Click Test Connection to verify your credentials, then click Save Configuration.

Test Connection and Save Configuration buttons in AmwalPay settings within PayLexer

Webhooks (Not Supported)

AmwalPay does not currently support webhook integration.

Payment updates are handled directly within AmwalPay's processing flow
Real-time event notifications are not available
Payment status updates occur through standard API polling

This means payment confirmations may take slightly longer to appear compared to gateways that support webhooks.

Integrate AmwalPay to Your Website

If you have already added and configured your site, you can enable AmwalPay in your existing setup.

Go to Websites

Navigate to Websites in your PayLexer dashboard.

Edit your website

Click the Edit Icon of your added website.

Enable AmwalPay

Click the checkbox to enable AmwalPay for the website.

If you haven't added a website yet, Continue to Add Your Website →

Troubleshooting

Verify Merchant ID, Terminal ID, and Secret Key are correct
Ensure you're using the right environment keys (Test vs Live)
Confirm credentials were received directly from AmwalPay support
Re-run Test Connection in PayLexer

Check whether credentials have been activated by AmwalPay
Verify you're not mixing Test and Live credentials
Contact AmwalPay support to confirm the status of your credentials

Verify AmwalPay is enabled in your integration
Ensure credentials match the environment (Test vs Live)
Confirm the currency is set to OMR — AmwalPay only processes Omani Rial transactions

Best Practices

Test in sandbox before enabling Production mode
Validate the first live transaction
Monitor the AmwalPay dashboard for payment updates (webhooks are not supported)
Keep API keys and secrets secure
Use separate Test and Production credentials
Ensure Debug/Test mode is enabled during testing and use only official AmwalPay test credentials
Confirm currency is set to OMR — AmwalPay only processes Omani Rial transactions

FAQs

Live credentials are mandatory to save the configuration. Test credentials are optional but highly recommended so you can safely test payments before going live.

AmwalPay credentials must be requested from AmwalPay support. Log in to your AmwalPay dashboard, note your Merchant ID, then contact support to request your Terminal ID and Secret Key for both Test and Live environments.

Check the Debug Mode setting in your platform (e.g., WP Travel Engine Settings → Payments). When Debug Mode is ON, PayLexer uses your Test credentials. When OFF, it uses Live credentials.

Transactions appear in three places: your platform's booking/order pages, PayLexer Dashboard → Orders, and AmwalPay Dashboard. All three show the same transactions with different IDs.

AmwalPay does not provide webhook functionality. PayLexer uses a polling mechanism to fetch payment status at regular intervals directly from AmwalPay. This ensures payment statuses are reflected in the PayLexer dashboard and your platform's orders or bookings, even without webhooks.

Still Have Questions?

AmwalPay Support:
- Through your Merchant Dashboard
- Support Email: support@amwalpay.om
- Support Phone: +968 24121845
PayLexer Support: Contact Support

Was this page helpful?

Last updated Apr 3, 2026

Built with Documentation.AI