Amwal Tech logoDocs

Shopify Installation Guide

Integrate Amwal 0% Bank Installments directly into your Shopify storefront. The official Amwal Shopify App supports full SAMA compliance, multi-bank 0% financing (3 to 24 months), and automatic order fulfillment synchronization.

Rendering diagram...

Prerequisites

  1. An active Shopify store (Shopify Basic, Shopify, Advanced, or Shopify Plus).
  2. An Amwal Merchant Account with your Merchant ID and Secret Key (see Integration Keys).

Installation Steps

1. Install the Shopify App

Open the Amwal Payment App on the Shopify App Store and click Install.

Shopify App Store Listing


2. Confirm Permissions in Shopify Admin

You will be redirected to your Shopify store administration panel. Review the required scopes and click Install app:

Confirm Permissions in Shopify Admin


After approving permissions, the Amwal configuration page opens:

Enter Amwal Merchant Credentials

  1. Enter your Merchant ID (Public Key) from the Amwal Merchant Dashboard.
  2. Enter your Secret Key.
  3. Click Authenticate & Save.

4. Activate Payment Gateway in Shopify Settings

In your Shopify Admin, navigate to Settings → Payments → Supported Payment Methods:

Shopify Payments Settings

  1. Locate Amwal Payment.
  2. Select the card brand payment icons you wish to display on checkout (Mada, Visa, Mastercard).
  3. Test Mode: Check Enable test mode if using sandbox credentials. Uncheck when ready to accept live transactions.
  4. Click Activate Amwal Payment:

Activate Amwal Payment Gateway


5. Final Confirmation

Once activated, Amwal will appear as an active primary payment method in your Shopify Payments list:

Amwal Active in Shopify Payments


Customer Checkout Experience

During the payment step of Shopify Checkout, customers select Amwal 0% Bank Installments:

Customer Checkout Screen in Shopify

  • Bi-lingual Title: Displays 0% credit card installments, + 2% miles/rewards (or Arabic: “0% تقسيط بالبطاقات الائتمانية، حتى 2% أميال/مكافآت”).
  • Seamless Authorization: Customers click Pay Now to select their Saudi issuing bank (Al Rajhi, SNB, Alinma, Riyad Bank) and choose their preferred installment term (3 to 24 months).
  • Instant Order Creation: Upon successful bank 3DS approval, the order transitions to Paid in Shopify Admin.

Next Steps

On this page