Troubleshooting Shopify Integration

If the Amwal 0% Bank Installments payment method does not appear in your Shopify checkout or the promotional marketing badge is not visible on your product pages, follow this diagnostic guide.

---

1. Amwal Not Appearing in Shopify Checkout

Issue 1: Store Currency is not SAR

• Requirement: Amwal 0% Bank Installments strictly require Saudi Riyals (SAR) as the checkout currency per SAMA regulations.
• Fix:
  1. Open Shopify Admin → Settings → Store Details.
  2. Under Store Currency, ensure the currency is set to Saudi Riyal (SAR).
  3. If using Shopify Markets for cross-border commerce, ensure Saudi Arabia is assigned SAR as its local settlement currency.

Issue 2: Payment Gateway in Draft Status

• Fix:
  1. Go to Settings → Payments → Supported Payment Methods.
  2. Locate Amwal Payment and verify that the toggle is Active (not Draft or Inactive).
  3. Ensure your Merchant ID (Public Key) and Secret Key are entered without leading or trailing spaces.

---

2. Product Page Installment Widget Not Rendering

Activate Theme App Extension (Shopify Online Store 2.0)

If you are using a modern Online Store 2.0 theme (Dawn, Sense, Craft, etc.):

1. In Shopify Admin, open Online Store → Themes → Customize.
2. In the top navigation dropdown, select Products → Default product.
3. In the left template outline under the Product Information section, click Add block.
4. In the Apps tab, select Amwal Installment Widget.
5. Position the block directly beneath the Price block and click Save.

Vintage Themes (Liquid Architecture)

If you are using a legacy vintage theme that does not support Theme App Extensions, you can manually inject the Amwal marketing widget snippet into snippets/product-template.liquid directly below the price element.

---

3. Orders Not Transitioning to "Paid"

Symptom

Customer completes bank installment checkout, but the order remains in Payment Pending or Authorized in Shopify Admin.

Root Cause

Webhook synchronization delay or network timeout between Amwal and Shopify's payment callback infrastructure.

Resolution

1. In the Amwal Merchant Portal, navigate to Stores and verify your registered Shopify URL format (https://your-store.myshopify.com).
2. Open Developers → Webhook Logs to confirm that order.success events received an HTTP 200 response from Shopify.
3. If webhooks are failing, re-open the Amwal App inside Shopify Admin and click Authenticate & Save to refresh OAuth session tokens.

---

4. Switching Between Sandbox and Production

---

Related Guides