Prerequisites

• MultiSafepay account registered in one of the following countries: The Netherlands, Belgium, Spain, Italy, Germany.
• A MultiSafepay site API key.
• Country restrictions may apply per payment app.

Installation

To install Shopify Payments Apps, follow these steps:

1. Sign in to your Shopify backend.
2. Ensure that your Shopify user has the permissions to install new apps.
3. Check that the payment methods you want to use in Shopify are activated for your MultiSafepay account.
4. Select the desired payment methods, and install their apps using one or more of the following links:
   • American Express
   • Amazon Pay
   • Bancontact
   • Bank Transfer
   • Bizum
   • Card Payment
   • CBC
   • Direct debit
   • iDEAL
   • KBC
   • Maestro
   • MB WAY
   • Mastercard
   • Multibanco
   • MyBank
   • Visa
   • WeChat Pay
5. Click "Install".
6. If necessary, log in to your Shopify store.
7. On your admin page, click Install.
8. Under Settings:
   • MultiSafepay website API Key: Enter your site API key.
   • MultiSafepay Environment: Turn on if you are using a Test API key. Turn off for a Live API key.
9. Click Save.
10. Under Payment configuration click the button Payment configuration

• Enable Test Mode if you are using a Test API key. Turn off for a Live API key.
• Enable or disable payment icons according to your preferences.

⚠️

About API key and selected environment

For all the above-listed MultiSafepay payment apps, the same API key, and the selected environment (test or live) will be used. Once you change the API key in a payment app, or the environment selected, it is automatically changed for the other active apps associated with your shop.

---

User guide

Abandoned checkouts

MultiSafepay's Second Chance feature is not supported.

Shopify offers a similar native service. See Shopify – Recovering abandoned checkouts .

Checkout Configuration

Configure settings for this payment app: activate the payment method, switch between Shopify Test / Live mode.

In Settings > Checkout, you can configure which customer details to include in your order request:

• Customer contact method: We recommend setting up the checkout by using the email as the primary customer contact method.
• Customer information: We recommend setting up the shipping address phone number as required.

Note: for some payment methods, certain customer data is required, e.g. phone number is required for Amazon Pay payments.

Currencies

Via MultiSafepay, you can only accept payments in EUR.
Ensure the default currency is set to EUR under Settings > General > Store defaults > Currencies to display.

Payment capture method

Payment capture method will be forced to Automatically at checkout when a customer submits the order request via one of these apps.

Reconciliation

To match orders in your accounting system with your MultiSafepay account, use the MultiSafepay order ID and the Shopify payment ID.

Refunds

Full and partial refunds are supported via your MultiSafepay dashboard and backend.

How to process a refund in your backend

1. Sign in to your Shopify backend.
2. Go to Orders.
3. Select the order you want to refund.
4. Click Refund, enter the refund amount, and confirm.
5. A refund request is sent to MultiSafepay. The refund status is updated in your Shopify backend as pending.
6. The refund is processed by MultiSafepay. The refund status is updated in your Shopify backend as refunded.

Notes

• The refund amount cannot exceed the original transaction amount.
• Refunds are not processed in real-time.
  • The refund status is updated in your Shopify backend as pending until the refund is processed by MultiSafepay.
  • While the refund is pending in your Shopify backend, refund will appear as reserved in your MultiSafepay account.

Uninstallation

To uninstall, follow these steps:

1. Ensure that your Shopify user has the permissions to uninstall apps.
2. On your admin page, go to Settings > Apps and sales channels.
3. Select the MultiSafepay payment app you want to uninstall, and clicking on the three dots icon, select the option Uninstall.
4. On the dialog window, select a reason and confirm the action by clicking Uninstall button.

---

Troubleshooting

Payment Order ID

How to troubleshoot Shopify issues

If you experience issues with order statuses, or refund statuses not updating, we will need the payment ID of the original transaction to investigate the issue.

1. Sign in to your Shopify backend.
2. Go to Orders.
3. Select the order related to the issue you want to report.
4. In the timeline, look for the earliest payment event and find the Payment ID.
5. Include the payment ID when reporting your issue to <a href="mailto:[email protected]">MultiSafepay support.

---

Top of page