MultiSafepay plugin for Magento 1

You can apply surcharges (payment fees) of a percentage or a fixed amount to transactions for every payment method.

For how applying surcharges may affect your webshop in relation to PSD2, see Payment Services Directive 2.

You can also:

• Set the tax class for surcharges.
• Show transaction amounts excluding the surcharge at checkout. Surcharges are always included at checkout.
• Show surcharges with our without VAT at checkout.

To apply a surcharge to a payment method in your backend, follow these steps:

1. Sign in to your Magento 1 backend.
2. Select systems and configuration.
3. In the MultiSafepay module, select the Option connect gateway.
4. Select the relevant payment method.
5. Under Payment fee amount, enter a surcharge percentage or fixed amount.
6. Place a test order to verify whether the fee has been correctly processed.

MultiSafepay processes payments in Euros (EUR) as the default currency. Our Magento 1 plugin follows the same default.

To change to a different currency for your webshop, follow these steps:

1. Sign in to your Magento 1 backend.
2. Go to System > Configuration > MultiSafepay x.x.x > Connect settings.
3. Under Allow currency conversion to Euro, change to No.

To make the MultiSafepay Magento 1 plugin compatible with Picqer, follow two additional steps, because orders must not receive Cancelled status.

1. In your Magento 1 backend, go to the MultiSafepay Connect settings.
2. Link Expired status to Waiting status.
3. Open app\code\community\MultiSafepay\Msp\Model\Base.php, and then copy the file to the local folder in the Magento structure.
4. Find the line $order > cancel(); at the expired signal and remove it.

All expired orders retain Waiting status until you cancel them:

• Manually
• With a custom cronjob
• Using a plugin

The Magento 1 plugin offers 3 generic gateways and 3 generic gift cards. Generic gateways support:

• All payment methods
• Refunds
• Backend orders

You can filter generic gateways by country, and minimum and maximum amount.

To configure generic gateways:

1. Sign in to your backend.
2. Go to System > Configuration > MultiSafepay > Connect gateways > Generic 1/2/3.
3. Set the relevant payment method gateway IDs and the gateway label.
4. Set how to display the payment method logos.
5. For pay later methods, set whether to include the shopping cart.

To enable recurring payments:

1. Sign in to your Magento 1 backend.
2. Go to Stores > Configuration > MultiSafepay > MultiSafepay settings.

For more information, see Recurring Payments.

Credit cards Recurring Payments are not available for the generic credit card gateway. You must enable the Visa, Mastercard, and/or Maestro gateways separately. This displays the Save card option at checkout.

Klarna requires the customer’s gender and date of birth. By default, the customer fills in this information in the Magento checkout in the Klarna payment method fields. The gender is automatically filled by the core Magento field.

You can disable both fields on the Klarna payment method. The customer then enters this information on the MultiSafepay payment page.

This change is only for Magento developers. We recommend testing the change and placing it in your local folder.

To disable Klarna gender and date of birth fields, follow these steps:

1. Open app\code\community\MultiSafepay\Msp\Model\Gateway\Klarna.php.
2. Comment this line protected $_formBlockType = 'msp/klarna';
3. Save the file.
4. Clear your cache.
5. Test the change.

Refund rules

• From your MultiSafepay dashboard: Full refunds
• From your Magento 1 backend (see below):
  • Full refunds and credit memos
  • Refunding more than the original transaction is not supported
• Refunds processed in your MultiSafepay dashboard may not appear in your backend.
• For pay later methods, you can only refund a selected item from the order, not a set amount. If you enter an amount instead of selecting an item, the entire order is refunded.

To process refunds from your backend, follow these steps:

1. Sign in to your Magento 1 backend.
2. Go to System > Configuration > MultiSafepay > Connect settings.
3. Check that you have:
   • Entered an API key
   • Enabled the Credit Memo option
4. Search for and open the order you want to refund.
5. Click the Invoices tab on the left of the Order overview.
6. Open the invoice, and click Credit memo at the top right of the overview.
7. Enter the refund amount, and then click Refund online to send the request to MultiSafepay.

The status of all complete orders automatically changes to Shipped in order to collect funds from pay later payment methods.

Our plugin is compatible with most Magento 1 checkouts. However, we cannot guarantee that all checkout features will function properly.

We test our plugin with:

• Magento 1 core checkout
• OneStepCheckout.com (Idev)

There are 3 ways to update the plugin:

• In your backend
• In the CMS marketplace
• Using SFTP

To update the plugin via SFTP, follow these steps:

1. Make sure you have a backup of your production environment, and that you test the plugin in a staging environment.
2. From the Magento 1 manual, download the plugin again.
3. Follow the Installation and configuration instructions from step 2.