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.
Log in to AmwalPay
Log in to your AmwalPay Dashboard and note your Merchant ID, found in the bottom-left corner of the dashboard.
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
Log in to your PayLexer dashboard and navigate to Payment Gateways → AmwalPay.
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.
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
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
Still Have Questions?
-
AmwalPay Support:
-
Through your Merchant Dashboard
-
Support Email: support@amwalpay.om
-
Support Phone: +968 24121845
-
-
PayLexer Support: Contact Support
Last updated 4 days ago
Built with Documentation.AI