Installation

Requirements

• CS-Cart and Multi-Vendor 4.17.2 – 4.21.x (tested on CS-Cart 4.17.2, Multi-Vendor 4.17.2 and Multi-Vendor 4.21.2 with PHP 8.3).
• PHP 7.4 – 8.3, as supported by your CS-Cart version.
• A PayTR merchant account. You need the Merchant ID (Mağaza no), Merchant key (Mağaza parola) and Merchant salt (Mağaza gizli anahtar) from PayTR Merchant Panel > Information (Bilgi).
• The PHP cURL extension (used by CS-Cart for all outgoing HTTP calls).
• HTTPS on the storefront is strongly recommended; it is required for the Direct API.
• The store must be reachable from the internet so PayTR can call the notification URL. A store on localhost cannot receive PayTR notifications.

Install from the package

1. Open Add-ons → Manage add-ons in the admin panel.
2. Click the gear icon → Manual installation and upload kv_paytr_payments-1.0.0.zip.
3. Find PayTR Payments (iFrame, Installments, Link) in the list. The add-on is installed and set to Active.
4. Continue with Configuration: create a payment method and set up the PayTR merchant panel.
5. On the License tab of the settings, enter your license key and save. If you bought the add-on on the CS-Cart Marketplace and entered the license number in Add-ons → Manage add-ons, you can skip this step. Until a key is verified, the add-on works for 14 days (see License).

The installer registers two payment processors, PayTR iFrame and PayTR Direct API (card form), and creates five tables:

Table	Content
cscart_kv_paytr_transactions	One row per payment attempt (PayTR merchant_oid), with status, amounts and the last notification
cscart_kv_paytr_refunds	Refund requests and their result
cscart_kv_paytr_links	Payment links created from the admin panel
cscart_kv_paytr_transfers	Multi-Vendor platform transfers
cscart_kv_paytr_vendor_accounts	Vendor bank accounts (holder name, IBAN) for transfers

The package mirrors the store root:

app/addons/kv_paytr_payments/
design/backend/templates/addons/kv_paytr_payments/
var/themes_repository/responsive/templates/addons/kv_paytr_payments/
var/themes_repository/responsive/css/addons/kv_paytr_payments/
var/langs/en/addons/kv_paytr_payments.po
js/addons/kv_paytr_payments/func.js

Custom themes not based on Responsive

Copy these folders into the theme after installation, then clear the cache:

var/themes_repository/responsive/templates/addons/kv_paytr_payments → design/themes/<theme>/templates/addons/
var/themes_repository/responsive/css/addons/kv_paytr_payments       → design/themes/<theme>/css/addons/

Upgrading

1. In Add-ons → Manage add-ons, upload the new package with Manual installation.
2. CS-Cart sees that the add-on is already installed and offers two ways:
   • Use the dangerous way (tick I know the risks… first) replaces the add-on files and keeps all add-on data. Choose this one. Despite its name, it is the normal way to upgrade this add-on.
   • Use the safe way uninstalls the add-on first. That deletes the settings, transactions, refunds, payment links, transfers and vendor accounts, and it disables the payment methods that use PayTR, then installs the new version from scratch.
3. Open any page of the admin panel. On that first page view the add-on completes the upgrade by itself. It adds any new database tables and columns, new settings (with their default values), new language variables and e-mail templates. It also updates the version shown in Add-ons → Manage add-ons. Existing data and setting values are kept.

When files are uploaded over an installed add-on, CS-Cart resets the add-on’s language variables to the texts in the package. If you edited them in Administration → Languages → Translations, apply your edits again.

If you bought the add-on on the CS-Cart Marketplace, you can also upgrade it in Administration → Upgrade center. Steps 2 and 3 then happen automatically. The Upgrade center closes the storefront while it works. Reopen the storefront afterwards; the e-mail the Upgrade center sends links to the right page.

Upgrading to 1.1.0: this version adds the license check. After the upgrade the add-on keeps working for 14 days; enter your license key on the License tab of the settings within that time.

See the CHANGELOG for what changed in each version.

Uninstalling

Add-ons → Manage add-ons → PayTR Payments → Uninstall removes:

• the two PayTR processors; payment methods that used them are disabled and their credentials are cleared;
• the add-on tables listed above, including the transaction, refund and transfer history;
• the add-on settings, the cached installment rates and all kv_paytr_payments.* language variables.

Order statuses and the payment details saved on orders (transaction ID, amounts) are kept. Export the PayTR transactions log first if you need the history.

See CHANGELOG for what changed in each version.