No reviews found
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 |
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- 4.20.1
- 4.19.1.SP2
- 4.19.1.SP1
- 4.19.1
- 4.18.4
- 4.18.3
- 4.18.2.SP1
- 4.18.2
- 4.18.1.SP1
- 4.18.1
- 4.17.2.SP3
- 4.17.2.SP2
- 4.17.2.SP1
- 4.17.2
- 4.17.1
- 4.16.2
- 4.16.1
- 4.15.2
- 4.15.1.SP4
- 4.15.1.SP3
- 4.15.1.SP2
- 4.15.1.SP1
- 4.15.1
- 4.14.3
- 4.14.2.SP1
- 4.14.2
- 4.14.1.SP1
- 4.14.1
- 4.13.3
- 4.13.2.SP2
- 4.13.2.SP1
- 4.13.2
- 4.13.1
- 4.12.2
- 4.12.1
- 4.11.5
- 4.11.4
- 4.11.3
- 4.11.2
- 4.11.1
- 4.10.4.SP1
- 4.10.4
- 4.10.3
- 4.10.2
- 4.10.1
- 4.9.3
- 4.9.2
- 4.9.1
- 4.8.2
- 4.7.4
- 4.6.3
- English
Contact information
Cartmodules operates a team of professional web designers and developers, providing premium CS-Cart services like add-ons development and theme development at affordable prices. We not only work effectively but smartly and deliver the best to our customers in shortest possible and ensuring quality of the deliverables.
We have an experienced team of professional having experience in PHP, JavaScript, Smarty, jQuery, CSS, Ajax, HTML5 and other programming languages and technologies. The development is inline with latest quality standards.
Our customers include a number of small, medium and large enterprises who are into e-commerce and want to expand further their business using technology.
Similar products
Make purchases for 200$ from our entire offer and get 20% discount
The module "TargetSMS: SMS notifications" is intended for sending SMS text notifications to an administrator and buyers of online store.