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.
- Open Extensions > Installer, choose Upload and select magicpay.ocmod.zip.
- Once uploaded, select Install on the MagicPay row in the installer list.
- Open Extensions > Extensions, choose Payments as the extension type and select Install beside MagicPay again.
- 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.