
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.
- 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
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.
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
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


Cart Discounts (Amount-Based and N+1) for OpenCart

Trendyol Connector for OpenCart 3.x and 4.x — Trendyol prices, stock and orders in your shop

Paraşüt e-Arşiv and e-Fatura for OpenCart 3.x and 4.x — invoices from the order page
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
- Install the archive for your OpenCart version and install the method in “Payments”.
- 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.
- Paste the keys on the “General” tab, choose the environment and press “Check connection”.
- Set the method name, the minimum total and the geo zone on the “Checkout” tab.
- Place an order in Turkish lira and pay on the Sipay page: after the return the order gets the status “Paid”.
- 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
- OpenCart 4: Extensions → Installer, upload cc_sipaytr.ocmod.zip without renaming it.
- OpenCart 3.x: Extensions → Installer, upload cc_sipaytr-oc3.ocmod.zip, then Extensions → Modifications → Refresh.
- 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.
- Extensions → Payments → Sipay Payments (CatCode): install it and open the settings.
- Paste the App ID, the App Secret and the Merchant Key, choose the environment and press “Check connection”.
- 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.
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.
No reviews yet. Be the first.
No questions yet. Ask one — we answer within 24 hours.
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
Buying the module
—
Charged in UAH; your bank converts it to your currency. EUR price is approximate.




















