Built for your store

Accept PrestaShop payments through MagicPay

Connect your PrestaShop store to POS services through MagicPay, with hosted card entry and payment and refund operations tied to your orders.

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

A hosted payment journey for PrestaShop

The MagicPay PrestaShop module redirects customers from your store's payment step to a MagicPay-hosted page. Customers enter card details there, while MagicPay selects the POS used for the payment. Your checkout method connects to the POS records on your MagicPay account, which needs at least one active POS.

Installation uses PrestaShop's Module Manager. After uploading the package, open Configure to enter credentials and enable payments. Preserve existing payment settings and review the package information against your store environment. Request the installation package through the demo or contact channel.

Upload and configure the module

Obtain test API key and Secret key values from Ayarlar > API Yetki Yönetimi in the MagicPay panel. Enter them only in the intended configuration fields and keep the secret out of shared documents. Uploading the module does not replace saving its payment settings.

  1. Open Modules > Module Manager in the PrestaShop administration panel.
  2. Select Upload a module and drag magicpay-prestashop.zip into the window, or choose the file.
  3. When installation finishes, select Configure to open MagicPay's settings.
  4. Enter API key and Secret key, enable the payment method and leave Test mode on. Select Save.

Review module settings and order results

Use the Sanal POS tab within the module configuration to review your MagicPay account's POS records. It is not a per-order bank selector; MagicPay handles routing. Reopen the configuration after saving to check that the payment method and test mode remain enabled.

Add a product to the storefront cart and make a MagicPay test payment. Compare the PrestaShop order amount and status with the transaction in MagicPay. For stores using TRY, USD or EUR, test the currency used by your store. If the result does not reach the order, check public HTTPS access. The module includes its callback address in each payment request.

Check payments and refunds before launch

Review a declined attempt as well as a successful payment and the customer's return. Keep full or partial refund tests within the remaining refundable balance, accounting for previous refunds. Compare the resulting records in both systems.

Return to Configure, disable test mode, enter live credentials and save. Compare early live orders with MagicPay transactions. Repeat the order checks after changes to your theme or checkout layout.

Frequently asked questions

Where do I install the module?

Use Modules > Module Manager > Upload a module, select magicpay-prestashop.zip, then open Configure.

Where are API and POS settings?

Enter API credentials in the module configuration. POS records are available in its Sanal POS tab.

Which amount limits a partial refund?

The remaining refundable balance after previous refunds. A new refund must not exceed that amount.