CartModules: Payme Payment Gateway
Accept Payme Payments in Your CS-Cart Store (Uzbekistan)
Integrate Payme -- one of Uzbekistan's major payment platforms -- directly into your CS-Cart or Multi-Vendor store. Customers complete payment through Payme's secure hosted checkout page using cards, wallets, and bank accounts.
Key Features
- Payme Hosted Checkout -- Customers pay on Payme's secure page using cards, wallets, or bank transfers
- Redirect-Based Flow -- No sensitive payment data touches your server (PCI SAQ A compliant)
- JSON-RPC 2.0 Webhooks -- Real-time transaction notifications with authenticated webhook handling
- Automatic Order Updates -- Orders are updated via webhook when payment is confirmed
- Sandbox/Production Toggle -- Switch between test and live environments from the admin panel
- Configurable Order Statuses -- Map Payme transaction states to any CS-Cart order status
- Basic Auth Security -- Webhook requests verified using timing-safe hash comparison
- Idempotent Callbacks -- Duplicate webhook notifications are safely ignored
- UZS Currency -- Native Uzbek Sum support with automatic tiyin conversion
Requirements
- CS-Cart or Multi-Vendor 4.x
- PHP 7.1 or higher
- Payme merchant account with API credentials (Merchant ID and Merchant Key)
- Store currency set to UZS (Uzbek Sum)
How It Works
- Customer selects Payme at checkout and clicks "Place Order"
- The addon builds a secure checkout URL and redirects the customer to Payme
- Customer completes payment on Payme's hosted checkout page
- Payme sends a JSON-RPC webhook notification to your store
- The addon verifies the webhook, updates the order status, and confirms to Payme
- Customer is redirected back to the order confirmation page
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 "Payme Payment Gateway" as the processor
- Enter your Merchant ID and Merchant Key from the Payme merchant dashboard
- Copy the webhook URL and configure it in your Payme merchant dashboard
- 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 Uzbekistan. Payme supports UZS (Uzbek Sum). Amounts are automatically converted to tiyin (1 UZS = 100 tiyin) for the Payme API. Ensure your store's primary currency is UZS.
