CartModules: Atmos Payment Gateway
Accept payments from Uzbekistan's most popular card networks. Integrate Atmos into your CS-Cart store to accept UZCARD and HUMO card payments in Uzbekistani Som (UZS). Secure redirect-based flow ensures your store never handles card data directly.Overview
The Atmos Payment Gateway addon connects your CS-Cart or Multi-Vendor store to the Atmos payment system in Uzbekistan. Atmos provides access to the two major domestic card networks — UZCARD and HUMO — enabling you to accept payments from millions of cardholders across Uzbekistan.
The addon uses the modern Atmos REST API with OAuth2 authentication, providing a secure and reliable payment experience for both merchants and customers.
Key Features
- UZCARD & HUMO Support — Accept payments from both major Uzbek card networks
- Secure Redirect Flow — Customers enter card details on Atmos-hosted page (PCI SAQ A compliant)
- OAuth2 Authentication — Modern token-based API security with automatic refresh
- Server-to-Server Callbacks — Reliable order status updates even if the customer closes their browser
- Idempotent Processing — Prevents duplicate order updates from multiple callbacks
- Sandbox Environment — Test your integration before going live
- Configurable Status Mapping — Map Atmos payment results to your preferred CS-Cart order statuses
- Comprehensive Logging — Full audit trail with sensitive data automatically redacted
- Multi-Vendor Compatible — Works with both CS-Cart and Multi-Vendor editions
How It Works
[Payment Flow Diagram]Checkout → Atmos Authentication → Transaction Created → Redirect to Atmos → Customer Pays → Callback → Order Updated
| Step | Description |
|---|---|
| 1 | Customer selects Atmos at checkout and clicks "Place Order" |
| 2 | The addon authenticates with Atmos API and creates a payment transaction |
| 3 | Customer is redirected to the secure Atmos payment page |
| 4 | Customer enters their UZCARD or HUMO card details and confirms payment |
| 5 | Customer is redirected back to your store's order confirmation page |
| 6 | Atmos sends a server-to-server callback to confirm the payment status |
| 7 | Order status is updated automatically based on the payment result |
Installation Guide
- 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 add a new payment method
- Select Atmos (Uzbekistan) as the processor
- Enter your Atmos credentials and save
Configuration
[Admin Configuration Screenshot]Payment method settings page showing Store ID, API Key, Secret Key, and status mapping fields
| Field | Required | Description |
|---|---|---|
| Payment Mode | Yes | Switch between Test (Sandbox) and Live (Production) environments |
| Store ID | Yes | Your merchant Store ID from the Atmos partner portal |
| API Key | Yes | API Key provided by Atmos for your store |
| Secret Key | Yes | Secret Key provided by Atmos for your store |
| Status: Success | No | CS-Cart order status for successful payments (default: Processed) |
| Status: Failed | No | CS-Cart order status for failed payments (default: Failed) |
| Status: Pending | No | CS-Cart order status for pending payments (default: Open) |
Getting Your Atmos Credentials
- Register as a merchant at partner.atmos.uz
- Complete the merchant verification process
- Navigate to your merchant dashboard
- Find your Store ID, API Key, and Secret Key in the integration settings
- For testing, use the sandbox portal at partner-test.atmos.uz
Security
- PCI SAQ A Compliant — Your store never handles or stores card data
- TLS Enforced — All API communication uses HTTPS with SSL peer verification
- Sensitive Data Redacted — API keys and tokens are automatically stripped from log files
- Input Validation — All request parameters are type-cast and sanitized
- Parameterized Queries — All database operations use CS-Cart's parameterized query system
Currency
This addon works with UZS (Uzbekistani Som). Make sure UZS is configured as a currency in your CS-Cart store under Administration > Currencies.
Compatibility
| Platform | Supported |
|---|---|
| CS-Cart 4.x | Yes |
| Multi-Vendor 4.x | Yes |
| CS-Cart Ultimate | Yes |
| PHP 7.1+ | Yes |
| PHP 8.x | Yes |
- 4.10.1
- 4.10.2
- 4.10.3
- 4.10.4
- 4.10.4.SP1
- 4.11.1
- 4.11.2
- 4.11.3
- 4.11.4
- 4.11.5
- 4.12.1
- 4.12.2
- 4.13.1
- 4.13.2
- 4.13.2.SP1
- 4.13.2.SP2
- 4.13.3
- 4.14.1
- 4.14.1.SP1
- 4.14.2
- 4.14.2.SP1
- 4.14.3
- 4.14.3.SP1
- 4.15.1
- 4.15.1.SP1
- 4.15.1.SP2
- 4.15.1.SP3
- 4.15.1.SP4
- 4.15.2
- 4.16.1
- 4.16.2
- 4.17.1
- 4.17.2
- 4.17.2.SP1
- 4.6.3
- 4.7.1
- 4.7.2
- 4.7.3
- 4.7.4
- 4.8.1
- 4.8.2
- 4.9.1
- 4.9.2
- 4.9.3
- English
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Store Builder
- Store Builder Plus
- Store Builder Ultimate
Addons features
- Backend
- For customer
- For owner
- For vendor
Shared features
No reviews found








