CartModules: Thawani Payment Gateway
Accept Thawani Payments in Your CS-Cart Store
Integrate Thawani — Oman's leading payment gateway — directly into your CS-Cart or Multi-Vendor store. Customers complete payment through a secure hosted checkout page supporting credit/debit cards and local Omani payment methods.
Key Features
- Thawani Hosted Checkout — Customers pay on Thawani's secure payment page
- Redirect-Based Flow — No sensitive card data touches your server (PCI SAQ A compliant)
- Automatic Order Updates — Session status is verified on customer return
- Sandbox/Production Toggle — Switch between test and live environments from the admin panel
- Configurable Order Statuses — Map Thawani statuses (paid, unpaid) to any CS-Cart order status
- Bearer Token Authentication — Secure API communication using Thawani's Secret Key
- Idempotent Callbacks — Duplicate callbacks are safely ignored
- OMR Currency — Native Omani Rial support with baisa conversion
Requirements
- CS-Cart or Multi-Vendor 4.x
- PHP 7.1 or higher
- Thawani merchant account with API credentials (Secret Key, Publishable Key)
- Store currency set to OMR (Omani Rial)
How It Works
- Customer selects Thawani at checkout and clicks "Place Order"
- The addon creates a checkout session via the Thawani API
- Customer is redirected to Thawani's hosted payment page
- Customer enters payment details and completes the transaction
- Thawani redirects back to your store and the addon verifies the session status
- Order status is updated automatically based on the payment result
Installation
- Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
- Activate the addon and enter the license key
- Go to Administration > Payment methods and create a new payment method
- Select "Thawani Payment Gateway" as the processor
- Enter your Secret Key and Publishable Key from the Thawani merchant portal
- Configure order status mappings as desired
- Save and test with sandbox mode before going live
Country & Currency
This addon is designed for merchants selling in Oman. Thawani uses OMR (Omani Rial) with amounts expressed in baisa (1 OMR = 1000 baisa). Ensure your store's primary currency is OMR.
