Built for your store

Connect nopCommerce orders to MagicPay payments

Connect nopCommerce to POS services through MagicPay, with hosted card entry for customers and order-linked payment and refund operations for your team.

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

Hosted card payments for nopCommerce

The MagicPay nopCommerce plugin redirects customers from checkout to MagicPay's hosted payment page. Card details are entered there, and MagicPay handles POS routing. The package targets nopCommerce 4.90 and .NET 9. Request it through the demo or contact channel and preserve your existing payment configuration.

Installing the local plugin and activating the payment method are separate tasks. Installation also requires an application restart. Choose an appropriate time for that interruption and confirm that administration access returns afterwards. Start payment checks in a test environment.

Install locally and restart the application

Obtain test API key and Secret key values from Ayarlar > API Yetki Yönetimi in MagicPay. Keep the secret private. Complete the restart after installing the plugin before moving on to payment-method configuration.

  1. Open Configuration > Local plugins, select Upload plugin or theme and choose the supplied nopCommerce package.
  2. Select Install beside MagicPay, then use Restart application to apply changes.
  3. Once the application returns, open Configuration > Payment methods. Select Is active for MagicPay and open Configure.
  4. Enter API key and Secret key, leave Test mode enabled and save. Recheck that the payment method is active.

Check the payment method and order outcome

Use the Sanal POS tab in MagicPay's configuration to review account POS records. At least one must be active. You do not select a bank for each order here; MagicPay determines routing. Keep the distinction between an installed plugin and an active payment method when reviewing the administration screens.

Add a product to the cart and use a test card on the MagicPay page. Compare the nopCommerce order's payment status with the transaction in MagicPay. If the result is missing, check public HTTPS access. The plugin supplies the callback address with the payment request. Also confirm that a declined attempt leaves the order unpaid.

Save live settings and prepare for updates

Keep full or partial refund tests within the remaining refundable balance, allowing for earlier refunds. Check the order amount, payment result and customer's return. Disable test mode in Configure, enter live keys and save when checks are complete.

For updates, upload the new package through Upload plugin or theme and restart the application. Recheck the active payment method and intended environment, then review an order's payment journey. Plugin visibility alone is not payment verification.

Frequently asked questions

When should I restart the application?

After selecting Install in Local plugins, use Restart application to apply changes. Configure the payment method once the application returns.

Where is the payment method activated?

Select Is active for MagicPay under Configuration > Payment methods. Save credentials and the operating mode in Configure.

How is the package updated?

Upload the new package through Upload plugin or theme and restart. Recheck the payment method, settings and order journey.