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

1. Customer selects Payme at checkout and clicks "Place Order"
2. The addon builds a secure checkout URL and redirects the customer to Payme
3. Customer completes payment on Payme's hosted checkout page
4. Payme sends a JSON-RPC webhook notification to your store
5. The addon verifies the webhook, updates the order status, and confirms to Payme
6. Customer is redirected back to the order confirmation page

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 "Payme Payment Gateway" as the processor
5. Enter your Merchant ID and Merchant Key from the Payme merchant dashboard
6. Copy the webhook URL and configure it in your Payme merchant dashboard
7. Configure order status mappings as desired
8. 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.