CartModules: Param Payment Gateway

Accept Param Payments in Your CS-Cart Store

Integrate Param (Turk Elektronik Para) — a trusted Turkish payment gateway — directly into your CS-Cart or Multi-Vendor store. Customers complete payment using credit and debit cards through a secure 3D Secure authentication flow. Supports both modern REST API and legacy SOAP (TurkPos) API modes.

Key Features

• 3D Secure Authentication — Customers are redirected to Param's secure 3D Secure page for card verification
• Redirect-Based Flow — No card data touches your server (PCI SAQ A compliant)
• REST & SOAP API Support — Choose between the modern REST API or the legacy SOAP TurkPos Web Service
• Automatic Order Updates — Payment results are queried from Param and orders are updated automatically
• Server-to-Server Notifications — Supports notify callbacks for reliable order processing
• Test/Production Toggle — Switch between sandbox and live environments from the admin panel
• Configurable Order Statuses — Map Param results (approved, failed) to any CS-Cart order status
• Idempotent Callbacks — Duplicate callbacks are safely ignored without re-processing
• Turkish Lira (TRY) — Native support for the Turkish market
• Secure Logging — Sensitive credentials are automatically stripped from all log entries

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher (PHP SOAP extension required for SOAP API mode)
• Param merchant account with API credentials (Client Code, Client Username, Client Password, GUID)
• Store currency set to TRY (Turkish Lira)

How It Works

1. Customer selects Param at checkout and clicks "Place Order"
2. The addon initializes a payment session via the Param REST or SOAP API
3. Customer is redirected to Param's 3D Secure authentication page
4. Customer completes card verification
5. Param redirects the customer back to the store
6. The addon queries the transaction result from Param and updates the order status

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 "Param Payment Gateway (Turkey)" as the processor
5. Enter your Client Code, Client Username, Client Password, and GUID from the Param merchant panel
6. Choose your preferred API mode (REST or SOAP)
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 Turkey. Param supports TRY (Turkish Lira). Ensure your store's primary currency is TRY for accurate payment processing.