CartModules: Telr Payment Gateway

Accept Telr Payments in Your CS-Cart Store

Integrate Telr -- a leading UAE and Middle East payment gateway -- directly into your CS-Cart or Multi-Vendor store. Accept payments in AED, SAR, BHD, KWD, OMR, QAR, USD, EUR, and GBP through a secure hosted payment page.

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
• Hosted Payment Page -- Customers pay on Telr's secure page, no card data touches your server (PCI SAQ A compliant)
• Multi-Currency Support -- Accept AED, SAR, BHD, KWD, OMR, QAR, USD, EUR, GBP
• Automatic Order Updates -- Transaction status is verified on customer return and via server notification
• Sandbox/Production Toggle -- Switch between test and live mode from the admin panel
• Configurable Order Statuses -- Map Telr statuses (Paid, Cancelled, Pending, Failed) to any CS-Cart order status
• Server-to-Server Notifications -- Reliable order updates even if the customer closes their browser
• Idempotent Callbacks -- Duplicate callbacks are safely ignored
• Anti-Tampering -- Cart ID verification prevents order manipulation

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• Telr merchant account with API credentials (Store ID and Authentication Key)

Checkout Modes

Redirect Mode

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

Inline Mode

• Server creates payment page via Telr API
• Telr payment page embedded in iFrame on checkout page
• Customer pays without leaving your store

How It Works

1. Customer selects Telr at checkout and clicks "Place Order"
2. The addon creates an order session via the Telr REST API
3. In redirect mode: customer is redirected to Telr's hosted page
4. In inline mode: Telr page embedded in iFrame on checkout
5. Customer enters card details and completes the payment
6. The addon verifies the payment status and updates the order

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 "Telr Payment Gateway" as the processor
5. Enter your Store ID and Authentication Key from the Telr merchant portal
6. Configure order status mappings as desired
7. Save and test with sandbox mode before going live

Supported Countries & Currencies

This addon is designed for merchants in the UAE, Saudi Arabia, Bahrain, Kuwait, Oman, Qatar, and international markets. Telr supports AED, SAR, BHD, KWD, OMR, QAR, USD, EUR, and GBP.