PayTR Payments (iFrame, Installments, Link)
Add-on ID: kv_paytr_payments · Edition: CS-Cart & Multi-Vendor · Latest version: 1.1.1 · Compatible with: CS-Cart & Multi-Vendor 4.17.2 – 4.21.x, PHP 7.4 – 8.3 · Changelog: view
Accept card payments in your CS-Cart or Multi-Vendor store through PayTR, with installments and 3-D Secure. The add-on adds two payment processors and the tools around them:
- PayTR iFrame (recommended): the customer pays on PayTR’s secure payment page, embedded in your store. PayTR shows the installment options and handles 3D Secure. Card data never touches your server.
- PayTR Direct API (card form): the card form is shown on your own page and posts the card data straight to PayTR. The add-on looks up the card program from the first digits and offers the matching installment plans. This mode needs PayTR’s approval and puts your site in PCI DSS scope (SAQ A-EP).
Key features
Section titled “Key features”- iFrame API checkout with
paytr_tokensigning, order basket, installment limits (no_installment,max_installment), TL / USD / EUR / GBP (and RUB) payments, test mode and PayTR error display (debug_on). - Reliable payment notifications (Bildirim URL): every notification is verified with its HMAC hash, processed exactly once (PayTR retries until it gets
OK), and mapped to configurable order statuses. If the customer comes back before the notification, the add-on asks PayTR’s status inquiry API and never leaves an order in limbo. - Refunds from the admin order page: full or partial, as many times as needed up to the paid amount, with a refund history.
- Installment table on product pages from PayTR’s installment rates service, cached for 24 hours. A short hint at checkout shows the maximum number of installments.
- Pay-by-link for phone and manual orders: create a PayTR payment link from the order page, send it by e-mail or SMS through PayTR, and the order is marked paid automatically.
- Multi-Vendor marketplace transfers with the PayTR Marketplace (Pazaryeri) solution: each vendor’s share (vendor order total minus your commission) is sent to the vendor’s IBAN through PayTR’s platform transfer API, and the completed transfer is recorded as a withdrawal in the vendor balance. Without a marketplace agreement, Multi-Vendor orders are simply paid to your PayTR account.
- PayTR transactions log under Orders, with status, refunds and vendor transfers.
- PHP 7.4 to 8.3 compatible code, no core changes.
Compatibility
Section titled “Compatibility”| CS-Cart / 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) |
| PHP | 7.2.5 – 8.3 (the code is PHP 7.4-compatible; tested with PHP 8.1 and 8.3) |
| Themes | Responsive and Bright theme, plus child themes based on Responsive |
| PayTR | A PayTR merchant account (Mağaza). Direct API and marketplace transfers must be enabled by PayTR for your account. |
How it works in one paragraph
Section titled “How it works in one paragraph”When the customer places an order with a PayTR payment method, the add-on signs the order data and asks PayTR for a payment token. The customer is taken to a payment page in your store that embeds PayTR’s iFrame (or shows the Direct API card form). PayTR then calls your notification URL in the background with the result; the add-on checks the hash and changes the order status. The customer is redirected back to the order page. Every attempt is stored in its own table, so refunds, payment links, transfers and the transaction log all work from the same data.
Documentation
Section titled “Documentation”- Installation
- Configuration: PayTR merchant panel, payment method settings, add-on settings
- Usage: checkout, refunds, payment links, installment table, Multi-Vendor transfers
- Developer guide
- FAQ
Trademarks
Section titled “Trademarks”PayTR is a trademark of its owner. This add-on is made by Kavio Labs and is not endorsed by or affiliated with PayTR. The name PayTR describes compatibility only.