Built for your store

Set up MagicPay as an OpenCart payment extension

Connect OpenCart to POS services through MagicPay, with hosted card entry and payment and refund operations linked to your orders.

  • One connection to POS services
  • Card entry hosted by MagicPay
  • Order and refund operations

Connect OpenCart to hosted checkout

The MagicPay OpenCart extension connects your store's checkout to a MagicPay-hosted payment page. Customers enter card details on MagicPay, which also determines POS routing. Before installation, compare the package information with your store environment and preserve the existing payment settings. Start in a test environment rather than treating upload completion as launch approval.

OpenCart separates package installation from payment-extension installation. Seeing MagicPay in the installer does not mean the payment method has been installed and enabled. Check both stages before troubleshooting checkout visibility.

Keep the filename and complete both installations

Request the package through the demo or contact channel. Keep the archive named magicpay.ocmod.zip. OpenCart derives the extension folder from that filename, so renaming the package can break the expected installation layout.

  1. Open Extensions > Installer, choose Upload and select magicpay.ocmod.zip.
  2. Once uploaded, select Install on the MagicPay row in the installer list.
  3. Open Extensions > Extensions, choose Payments as the extension type and select Install beside MagicPay again.
  4. Open Edit, enter API key and Secret key, enable Status and keep Test mode on. Select Save.

Check credentials, POS records and notifications

Get credentials from Ayarlar > API Yetki Yönetimi in the MagicPay panel. Match test keys to test mode and keep the secret private. The Sanal POS tab on the OpenCart payment settings page provides access to your account's POS records. At least one must be active; this is not a per-order POS selector.

Place a test order from the storefront and complete the MagicPay page with a test card. Compare the OpenCart order record with the transaction in MagicPay. If the result does not reach the store, check public HTTPS access. The extension sends the callback address with the payment request. Also review a declined attempt and confirm the order remains unpaid.

Review saved settings before launch

Reopen Edit to check that Status and the intended operating mode were saved. Review the customer's return alongside the order result. Keep full or partial refund tests within the remaining refundable balance.

After successful checks, disable test mode, enter live keys and select Save. Compare early live orders against MagicPay records. Preserve the original archive name if you later upload the package again; filename changes affect OpenCart's installation structure.

Frequently asked questions

Which filename should I use for the package?

Upload the package as magicpay.ocmod.zip. OpenCart derives the extension folder from that filename.

Why are there two Install steps?

Install the package in Extensions > Installer, then install the payment extension under Extensions > Extensions > Payments.

Where can I review POS settings?

Use the Sanal POS tab in MagicPay's Edit screen. MagicPay handles routing rather than a per-order selection in OpenCart.