Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
OpenCart

Sipay for OpenCart — card payments with 3-D Secure, taksit installments and refunds (Turkey)

Sipay for OpenCart 4.x, 3.x, 2.3 (Turkey): card payments with 3-D Secure on the Sipay page; Pro adds taksit installments, USD and EUR, a webhook, refunds and a journal. Lifetime licence.

Pro · lifetime licence Staging copies are included. The more sites, the cheaper each one
Compatibility
OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · module languages: English, Türkçe
PHP
7.0 or newer
Version
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3)
Licence
a site + a staging copy, lifetime
Trial
7 days, no card, one per site
Updated
15.11.2026
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

What Free has,
and what Pro adds

The free version works with no time limit. Pro adds the rest of the features in the table.

Feature Free Pro
Card payment on the Sipay page with 3-D Secure ✔ ✔
Order status after the payment is read back from Sipay ✔ ✔
Amount and changed-cart check, the "Needs review" status ✔ ✔
Pay again and "Back" to the same link ✔ ✔
Test and live environments, connection check ✔ ✔
Minimum total, geo zone, name and description per language ✔ ✔
Payment block on the order page ✔ ✔
Charge currencies lira only (TRY), other currencies are converted TRY, USD, EUR
Installment payments 1 up to 12
Installment commission on the shop or the buyer — ✔
Sipay webhook (sale and refund) — ✔
Payment watchdog: settles orders when the buyer did not return — ✔
Full and partial refunds from the order page — ✔
Re-check of a payment at Sipay from the order page — ✔
Payment journal — ✔

What it looks like

Sipay at the checkout
The order total in lira and the “Continue to payment” button: the buyer goes to the secure Sipay page.
The payment page after a refusal
The payment did not go through: the buyer sees a plain message with the buttons “Pay again” and “Back to checkout”, and the cart stays.
The
Method name and description per language, minimum total, geo zone and sort order.

Key points

What the buyer and the shop get

At the checkout the buyer chooses “Sipay”, sees the total in lira and presses “Continue to payment”.

What is in the admin

Extensions → Extensions → Payments → Sipay Payments (CatCode): the tabs “General”, “Checkout”, “Order statuses” and “Pro”.

The trial starts when you ask

A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy

Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.

Technical requirements

  • OpenCart 4.0.2.x–4.1.x, 3.0.x or 2.3.0.2; PHP 7.0+ for 2.3, the cURL extension.
  • A contract with Sipay and a merchant account: the App ID, the App Secret and the Merchant Key from the merchant panel.
  • Sipay accepts requests only from server IP addresses its sales team has whitelisted, and returns buyers only to whitelisted domains: give Sipay the IPv4 address of the server and the shop domain before going live.
  • The payment link needs the buyer’s address and phone: the module takes the shipping address, and the phone only if the buyer gave one. If Sipay refuses the link for lack of these, the buyer sees “could not start the payment” and the order is not lost.
  • The first and last name are required by Sipay: if the order has none, the module sends “-“.
  • Installments work only in Turkish lira: payments in USD and EUR go as a single payment.
  • A Sipay payment link cannot be closed through the API: an old link stays payable, and a second payment for the same order is marked in the order, with the refund done by hand.
  • The Sipay webhook URL has to answer over HTTPS without a redirect.
  • On OpenCart 4 the payment watchdog runs from the built-in scheduler once an hour; on 3.x and 2.3, or instead of the scheduler, call the cron URL from the settings on your hosting, for example every 15 minutes.

Version history

v1.0.0 Current 15.11.2026

For OpenCart 4.x, 3.x and 2.3: card payment on the Sipay page with 3-D Secure, every payment read back from Sipay before the order changes, pay again, amount check, test and live…

Frequently bought with Sipay

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

Full module description

Sipay Payments for OpenCart 4.x, 3.x and 2.3 takes card payments through the Sipay (Turkey) virtual POS with your own merchant account: the buyer pays on the secure Sipay page with 3-D Secure, and the card never passes through your site. An order changes its status only after the module has read the payment back from Sipay.

What the buyer and the shop get

At the checkout the buyer chooses “Sipay”, sees the total in lira and presses “Continue to payment”. The module creates a Sipay payment link and sends the buyer to the secure page, where the card is entered, 3-D Secure is passed and, in Pro, the installments are picked from the Sipay table. After the payment Sipay sends the buyer back to the shop.

The order status changes only after the module has asked Sipay for the state of that payment. A buyer who returns sees the result on the payment page; if the payment did not go through, a “Pay again” button starts a new attempt and the cart stays. If the buyer presses “Back” on the Sipay page, the same link is offered (up to 30 minutes, the same amount) instead of a second order.

The paid amount is checked against the order. If the cart changed after the link was created, or Sipay returned a different amount, the order gets the status “Needs review” with an explanation. A second payment for the same order is marked in the order, so a double payment is not lost.

When the shop currency is not lira, the free version converts the amount into lira at the OpenCart rate or hides the method. In Pro, USD and EUR can be charged right on the Sipay page.

What is in the admin

Extensions → Extensions → Payments → Sipay Payments (CatCode): the tabs “General”, “Checkout”, “Order statuses” and “Pro”. In the Sipay merchant panel open “Settings → Integration & API”, copy the App ID (App Key), the App Secret and the Merchant Key, paste them on the “General” tab, choose the test or the live environment and press “Check connection”: the module gets a token, checks the Merchant Key and shows the installments active on the account. The App Secret and the Merchant Key are stored encrypted and are never shown again.

The “Checkout” tab holds the method name and the description under it for every shop language, the minimum total, the geo zone and the sort order. On the “Order statuses” tab you choose the statuses for “Paid”, “Needs review” and “Refunded”. The texts for the buyer are in English and Turkish, and amounts are shown in the shop’s format (for example 115.00 TL).

The Pro tab opens the installments: the highest number of payments up to 12 (the buyer picks from the table on the Sipay page), the installment commission paid by the shop or the buyer, the charge currency (USD, EUR or lira), the webhook address with its key, the state of the payment watchdog with a manual check button and the URL for the hosting cron. In Pro the order page shows the payment, the amount, the method, the Sipay invoice number, the payment attempts and the buttons “Check at Sipay” and “Refund” for a full or partial refund. The payment journal opens from the settings page.

Without a licence the Pro fields are shown disabled with an explanation, and saved Pro values do not reach the Sipay requests. The “Try Pro” button starts a 7-day trial.

How it works, step by step

  1. Install the archive for your OpenCart version and install the method in “Payments”.
  2. In the Sipay merchant panel take the App ID, the App Secret and the Merchant Key, and ask Sipay to whitelist your server IP and the shop domain.
  3. Paste the keys on the “General” tab, choose the environment and press “Check connection”.
  4. Set the method name, the minimum total and the geo zone on the “Checkout” tab.
  5. Place an order in Turkish lira and pay on the Sipay page: after the return the order gets the status “Paid”.
  6. In Pro turn on installments, the Sipay webhook, the payment watchdog and refunds from the order page.

Under the hood

  • Sipay REST API: token, payment link (purchase/link), status check (checkstatus), refund, installments list and webhooks.
  • The token is cached, the App Secret and the Merchant Key are encrypted, and no card data reaches your site.
  • Every payment attempt has its own invoice number, and one payment never changes the order twice: parallel clicks, a webhook together with the buyer’s return, and repeats give one record.
  • Webhook and return data are checked by their signature, and then the payment state is still read from Sipay: a forged request changes nothing.
  • All calls to Sipay go over IPv4 with a time limit of 8.5 s per buyer action; if Sipay does not answer, the buyer sees a plain message and the cart stays.
  • The payment watchdog finds open payments (the buyer paid and closed the page) and settles the orders, the oldest first.
  • After the trial ends the Pro features turn off, and the free payment keeps working.
  • The interface is in English and Turkish; a debug log (never keys, card numbers or buyer data) is switched on in the settings.

Installation

  1. OpenCart 4: Extensions → Installer, upload cc_sipaytr.ocmod.zip without renaming it.
  2. OpenCart 3.x: Extensions → Installer, upload cc_sipaytr-oc3.ocmod.zip, then Extensions → Modifications → Refresh.
  3. OpenCart 2.3: Extensions → Installer, upload cc_sipaytr-oc23.ocmod.zip (the FTP settings in System → Settings → FTP are needed; otherwise unpack the archive and copy the contents of the upload/ folder into the shop root by hand), then Extensions → Modifications → Refresh.
  4. Extensions → Payments → Sipay Payments (CatCode): install it and open the settings.
  5. Paste the App ID, the App Secret and the Merchant Key, choose the environment and press “Check connection”.
  6. For Pro: paste the licence key or start the trial on the “Pro” tab.

Questions
about the module

Didn't find the answer? Message us on Telegram and we'll reply within a business day.

@catcode_support Setup, compatibility, activation
Is this the official Sipay module?

No, it is an independent integration through the public API. Sipay is a trademark of its owner.

Where do I get the App ID, the App Secret and the Merchant Key?

In the Sipay merchant panel: Settings → Integration & API. The contract and the merchant account are arranged with Sipay.

Why does "Check connection" or a payment return a refusal?

Sipay accepts requests only from whitelisted IP addresses and returns buyers only to whitelisted domains. Give Sipay the IPv4 address of the server and the shop domain.

Do cards pass through my site?

No. The buyer types the card on the secure Sipay page with 3-D Secure, and only the result comes back to the site.

When does an order become paid?

After the module has asked Sipay for the state of the payment and got "Completed". A buyer returning without Sipay confirming does not pay the order.

What if the buyer paid and closed the page?

In Pro the Sipay webhook and the payment watchdog settle such an order without the buyer returning. In the free version the order is confirmed when the buyer comes back to the site.

Are there installments?

Yes, in Pro: up to 12 payments in lira, the buyer picks from the Sipay table, and the commission can be put on the shop or the buyer. Only the installments active on your Sipay account are available.

Can I take USD and EUR?

Yes, in Pro. In the free version the module converts the amount into lira at the OpenCart rate or does not show the method.

Are saved cards supported?

No: Sipay does not offer them for the payment link, and typing the card on the shop site would need full PCI DSS compliance.

Which OpenCart versions are supported?

OpenCart 4.0.2.x–4.1.x, 3.0.x and 2.3.0.2: three separate archives in one product.

Is the licence lifetime?

Yes, for OpenCart it is one payment and a lifetime licence, for two sites.

What happens after the trial?

Pro turns off, and the free part keeps working.

Not quite what you are looking for?

We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.

Order a custom module