Amwal Tech logoDocs

High-Level Solution Architecture

Amwal provides a secure, cloud-native payment orchestration platform regulated by the Saudi Central Bank (SAMA, License PSP013) and certified under PCI-DSS Level 1.


Architecture Diagram

The diagram below illustrates the direct service flow between the Merchant Application and the Amwal Payment Platform:

Rendering diagram...

Service Flow Overview

Rendering diagram...

Integration & Operating Model

  1. Session Creation: The merchant backend server issues a secure server-to-server request (POST /payment_links/{store_id}/create) using their private API Secret Key.
  2. Hosted Checkout Redirection: Amwal returns a unique payment_url. The merchant redirects the customer to Amwal's PCI-compliant checkout modal (pay.sa.amwal.tech).
  3. Biometric Passkey & 0% Bank Installments:
    • Customers complete payment in 1 click using Biometric Passkeys (Touch ID, Face ID).
    • Eligible Saudi credit cards can convert their purchase into 0% Bank Installments (3, 6, 12, or 24 months).
  4. Order Reconciliation via Signed Webhooks: Upon payment authorization, Amwal immediately delivers an RSA-PSS SHA-256 signed order.success notification to the merchant's webhook endpoint for automated fulfillment.

Security & Compliance Highlights

DimensionSpecification
Regulatory LicenseAuthorized & Regulated by Saudi Central Bank (SAMA License PSP013).
Card Data SecurityPCI-DSS Level 1 Certified. Zero raw card data touches merchant servers.
AuthenticationPasswordless FIDO2 / WebAuthn Biometric Passkeys reducing checkout drop-off.
Integrity & EncryptionTLS 1.3 transport encryption and RSA-PSS SHA-256 cryptographic webhook signatures.

On this page