CartModules: PayTR Payment Gateway

Accept PayTR Payments in Your CS-Cart Store

Integrate PayTR — one of Turkey's most popular payment gateways — directly into your CS-Cart or Multi-Vendor store. Customers complete payment using credit/debit cards, BKM Express, bank transfers, and mobile payments through a secure hosted payment page with 3D Secure.

Key Features

• Dual Checkout Modes — Choose between redirect (hosted page) or inline (iFrame popup) checkout
• On-Site Payment — Inline mode embeds iFrame on checkout page for seamless experience
• PayTR Hosted Payment Page — Customers pay on PayTR's secure page with 3D Secure
• Redirect-Based Flow — No card data touches your server (PCI SAQ A compliant)
• HMAC-SHA256 Security — Token generation and callback verification using cryptographic hashing
• Automatic Order Updates — PayTR callbacks are verified and processed automatically
• Test/Production Toggle — Switch between test and live environments from the admin panel
• Configurable Order Statuses — Map PayTR statuses (success, failed) to any CS-Cart order status
• Idempotent Callbacks — Duplicate callbacks are safely ignored
• Turkish Lira (TRY) — Native support with automatic kurus conversion
• Multiple Payment Methods — Credit/debit cards, BKM Express, bank transfer, mobile payments
• 3D Secure Always On — All transactions use 3D Secure for maximum security

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• PayTR merchant account with API credentials (Merchant ID, Merchant Key, Merchant Salt)
• Store currency set to TRY (Turkish Lira)

Checkout Modes

Redirect Mode

• Customer is redirected to PayTR's hosted payment page
• Payment completed on the gateway's secure page
• Customer returns to your store after payment

Inline Mode

• Server creates an iFrame token from PayTR
• PayTR payment page embedded in iFrame on checkout page
• Customer pays without leaving your store

How It Works

1. Customer selects PayTR at checkout and clicks "Place Order"
2. The addon generates an HMAC token and requests a payment token from PayTR
3. In redirect mode: customer is redirected to PayTR's hosted page
4. In inline mode: PayTR page embedded in iFrame on checkout
5. Customer completes payment with 3D Secure verification
6. PayTR posts callback with transaction result and cryptographic hash
7. The addon verifies the hash 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 "PayTR Payment Gateway" as the processor
5. Enter your Merchant ID, Merchant Key, and Merchant Salt from the PayTR merchant panel
6. Configure order status mappings as desired
7. Save and test with test mode before going live

Country & Currency

This addon is designed for merchants selling in Turkey. PayTR primarily supports TRY (Turkish Lira). Amounts are automatically converted to kurus (smallest unit) before being sent to PayTR. Ensure your store's primary currency is TRY.