CartModules: Moyasar Payment Gateway

Accept Payments from Saudi Arabia in Your CS-Cart Store

Integrate Moyasar — Saudi Arabia's modern payment platform — directly into your CS-Cart or Multi-Vendor store. Accept payments via mada, Visa, Mastercard, Apple Pay, STC Pay, and SADAD through a secure hosted checkout flow.

Key Features

• Multiple Payment Methods — mada (Saudi debit), Visa, Mastercard, Apple Pay, STC Pay, SADAD
• Dual Checkout Modes — Choose between redirect (hosted page) or inline (embedded form) checkout
• On-Site Payment — Inline mode keeps customers on your store during payment
• Apple Pay — Accept Apple Pay payments via inline checkout
• Redirect-Based Flow — No sensitive data touches your server (PCI SAQ A compliant)
• Automatic Order Updates — Invoice is verified via API on customer return
• Webhook Support — Reliable payment confirmation via server-to-server callback
• Simple Configuration — Single API key determines test vs live environment
• Configurable Order Statuses — Map Moyasar statuses (paid, failed, initiated) to any CS-Cart order status
• Basic Auth Security — Secure API communication using Moyasar's official auth scheme
• Idempotent Callbacks — Duplicate callbacks are safely ignored
• SAR & USD Currency — Native Saudi Riyal support, plus USD
• Halala Precision — Amounts correctly converted to smallest currency unit

Supported Payment Methods

• mada — Saudi Arabia's national debit card scheme (most popular payment method in KSA)
• Visa — International credit and debit cards
• Mastercard — International credit and debit cards
• Apple Pay — Mobile wallet payments
• STC Pay — Saudi Telecom Company digital wallet
• SADAD — Saudi bill payment system

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• Moyasar merchant account with API credentials
• Store currency set to SAR (Saudi Riyal) or USD

Checkout Modes

Redirect Mode

• Customer is redirected to Moyasar's hosted payment page
• Payment completed on the gateway's secure page
• Customer returns to your store after payment

Inline Mode

• Moyasar Form builder renders an embedded payment form on your checkout page
• Customer pays directly without leaving your store
• Apple Pay available (requires domain verification)

How It Works

1. Customer selects Moyasar at checkout and clicks "Place Order"
2. The addon creates an invoice via the Moyasar API
3. In redirect mode: customer is redirected to Moyasar's hosted page
4. In inline mode: embedded form appears on checkout page
5. Customer chooses their preferred payment method (mada, Visa, MC, Apple Pay, STC Pay, or SADAD)
6. After payment, the addon verifies payment via API and updates the order status

Installation

1. Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
2. Activate the addon and enter the license key
3. Go to Administration > Payment methods and create a new payment method
4. Select "Moyasar Payment Gateway" as the processor
5. Enter your Moyasar Secret Key from the Moyasar Dashboard
6. Configure order status mappings as desired
7. Save and test with a test key (sk_test_) before going live

Country & Currency

This addon is designed for merchants selling in Saudi Arabia. Moyasar primarily supports SAR (Saudi Riyal). Amounts are automatically converted to halalas (1 SAR = 100 halalas) for the API. USD is also supported.

Test vs Live

Moyasar uses a single API URL. The environment is determined by your API key type: test keys start with sk_test_, live keys start with sk_live_. No separate mode toggle is needed.