CartModules: ThePay Payment Gateway

Accept ThePay Payments in Your CS-Cart Store

Integrate ThePay -- a leading Czech payment gateway supporting bank transfers, card payments, and local payment methods -- directly into your CS-Cart or Multi-Vendor store. Customers complete payment through a secure hosted checkout flow with multiple payment options.

Key Features

• ThePay REST API v2 -- Modern API integration for reliable payment processing
• Multiple Payment Methods -- Bank transfers, cards, and Czech/European local methods
• Redirect-Based Flow -- No sensitive data touches your server (PCI SAQ A compliant)
• Webhook Notifications -- Server-to-server payment confirmations with HMAC-SHA256 signature verification
• Automatic Order Updates -- Payment status verified on customer return and via webhook
• Sandbox/Production Toggle -- Switch between test and live environments from the admin panel
• Configurable Order Statuses -- Map ThePay states (paid, cancelled) to any CS-Cart order status
• Bearer Token Authentication -- Secure API communication using ThePay's official auth flow
• Idempotent Callbacks -- Duplicate callbacks and webhooks are safely ignored
• CZK & EUR Currencies -- Native Czech Koruna and Euro support

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• ThePay merchant account with API credentials (Merchant ID, Project ID, API Key, API Password)
• Store currency set to CZK or EUR

How It Works

1. Customer selects ThePay at checkout and clicks "Place Order"
2. The addon creates a payment via ThePay REST API v2
3. Customer is redirected to the ThePay hosted payment page
4. Customer selects their preferred payment method and completes the payment
5. Customer is redirected back to your store
6. The addon verifies the payment status and updates the order
7. ThePay also sends a webhook notification for server-side confirmation

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

Country & Currency

This addon is designed for merchants selling in the Czech Republic and Europe. ThePay supports CZK (Czech Koruna) and EUR (Euro). Ensure your store's primary currency is set to CZK or EUR.