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.
- Open Modules > Module Manager in the PrestaShop administration panel.
- Select Upload a module and drag magicpay-prestashop.zip into the window, or choose the file.
- When installation finishes, select Configure to open MagicPay's settings.
- 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.