Set up your account


To set up your test account, you must first add at least one website and generate an API key.

Website requirements

You can add an unlimited number of websites to your MultiSafepay account, but they must all be operated by the same legal entity linked to that account.

To process payments from a website operated by a separate legal entity, you must sign up for an additional MultiSafepay account.

  1. Sign in to your MultiSafepay test account.
  2. Go to Settings > Website settings.
  3. Click either:

    Quick add website

    1. From the Category dropdown menu, select what type of products or services your website sells.
    2. In the Description field, enter the website name. This is displayed on the MultiSafepay payment page and, depending on the payment method, on the customer’s bank statement.
    3. In the Base URL field, add the website’s URL. This must be the URL where you receive payments.
    4. In the Notification URL field, provide a notification URL for MultiSafepay to send status updates to, if required.
    5. Click Save.

    or for more advanced configuration:
    Website wizard

    1. Enter the website URL in the Full website URL field, or select it from the Select existing site dropdown, and then click Continue.
    2. From the Website platform dropdown, select your ecommerce platform.
      You are prompted to install the MultiSafepay plugin for your ecommerce platform in your website.
    3. From the Category dropdown, select the type of products and/or services you sell from this website, and then click Continue.
    4. If you want to receive transaction status updates via webhook, in the Notification URL field, enter a URL for us to send them to.
    5. In the Description field, enter the company name you want to appear on payment pages and customer bank statements, and then click Continue.
      A template of your MultiSafepay payment page is generated.
    6. Customize the template as required.
      • To toggle the view of the payment page, click:
        • List view to see all payment methods in a list
        • Detail view to display one detailed box for entering payment details and collapse all other payment methods
        • API view code to view the code
      • To replace the MultiSafepay logo in the top-left corner, after completing the wizard, upload your own logo under Settings > Payment page templates.
      • To hide the MultiSafepay logo in the top-left corner, on the lefthand side under Settings, select the Hide main logo checkbox.
      • On the lefthand side, under Header, Body, Container, Cart, Payment form, and Buttons, you can change the color of the background, text, lines, and links in different parts of the payment page.
      • To clear your changes and start again, click Reset style.
    7. To set this payment page as your default template, select the Set as default template checkbox.
    8. In the Save template as field, enter a name for this template.

    Your test account is now linked to your website.

  4. The Website settings page contains your:

    • Site ID
    • Secure code
    • API key
  5. Copy the API key to start building your integration. The API key also lets you monitor transactions, configure payouts, generate reports, and more.

Next steps

User guide

Site ID, API key, and secure code

Account API key

Your MultiSafepay account API key is automatically generated when your account is created. To retrieve it, email your account manager at [email protected]

Website API key, site ID, and secure code

To view the site ID, API key, and secure code for a specific website:

  1. Sign in to your live or test MultiSafepay account.

  2. Go to Settings > Website settings.

  3. Click on the relvant website to view the Website details page.

Connecting websites to your backend

To connect a website in your backend:

Most MultiSafepay ecommerce integrations require your API key, site ID, secure code, and account ID to connect to a website. Your account ID appears in the top-right corner of your MultiSafepay account. If you are building your own integration using our API, SDK, or wrapper, use the API key under your website settings.

  1. Enter the required details in the backend of your integration.

  2. The connection is finalized.

  3. Place a test order using our API to validate the connection.

Activating payment methods

Some payment methods you must apply to your account manager to activate, others you can activate yourself. Check the relevant payment method under Activation.

To activate payment methods in your MultiSafepay account account for:

All your websites:

  1. Go to Settings > Payment methods.
  2. Under Standard payment methods, select the relevant checkbox(es).
  3. Click Save changes.

A specific website, if you manage multiple websites that support different payment methods:

  1. Go to Settings > Website settings.
  2. Click the relevant website to open the Website settings page.
  3. Under Payment methods, select the relevant checkbox(es).
  4. Click Save. Note: Make sure you enable the payment methods for every relevant website in your account.

Next, enable the payment methods in the backend of your integration to finalize the connection.

For any questions, email the Sales Team at [email protected]

Deleting websites

To delete a website from your MultiSafepay account, follow these steps:

  1. Sign in to your MultiSafepay account.

  2. Go to Settings > Website settings.

  3. For the website you want to delete, click the green Enabled button in the right most column.

  4. In the Disable payments dialog, click Delete.

Enabling two-factor authentication

Two-factor authentication (2FA) is an optional, additional layer of security for data in your MultiSafepay account. It is supported in every country.

When enabled, users must verify their identity with:

  • A password
  • A 6-digit token generated in the user’s MultiSafepay mobile app for every Sign in

Enabling 2FA

Administrator

To enable 2FA in your MultiSafepay account, you must have administrator rights.

  1. Sign in to your MultiSafepay account and go to User management.

  2. Click the name of the user you want to enable 2FA for to open the User details page.

  3. From the Two-factor dropdown menu, select Enable.

  4. Click Save changes.

Enabling Two-factor authentication in your MultiSafepay account

For support, email the Support Team at [email protected]

User

The first time the user logs in to MultiSafepay account after 2FA is enabled, they must configure 2FA.

  1. Sign in to MultiSafepay account on your laptop or PC. A dialog requesting a 6-digit token appears.

  2. Open or download the MultiSafepay app and Sign in.

  3. Tap More in the bottom-right corner.

  4. Tap Authenticator.

  5. Copy the 6-digit token from your mobile device to the 2FA dialog on your computer or laptop.

Generating a 6-digit 2FA token the in your MultiSafepay account app
The 6-digit token remains visible for 30 seconds

Notes:

  • You can only connect a mobile device to one user, and a user to only one mobile device.
  • After 5 unsuccessful 6-digit token inputs, the user’s account is blocked. Only administrators can unblock user accounts.
  • If a user loses their 2FA device, disable and re-enable 2FA on their account.

For support, email the Support Team at [email protected]

Adding users

You can add an unlimited number of users to your MultiSafepay account. All users on one account share the same secure code.

You can disable users, but not delete them.

To add users with different permission profiles, follow these steps:

  1. Sign in to your MultiSafepay account.

  2. Go to Settings > User management.

  3. Click Add new user in the top right corner.

  4. Enter the new user’s:

    • User name
    • Full name
    • Password
    • Email address
  5. From the Status dropdown menu, select Active.

  6. Under Rights on the right side of the page, select the appropriate user rights check boxes. See User rights overview below.

  7. Click Add user in the top right corner.

User rights overview

  • Administrator has access to all functionalities in the account
  • Reporting can:
    • See all transactions and the account’s MultiSafepay balance
    • Create and download reports
    • Generate payment links
  • Technical can:
    • Add and edit websites and payment pages
    • Edit email templates
  • Refund can:
    • Create refunds
    • See all transactions
    • Generate payment links
  • Basic can:
    • See all transactions
    • Generate payment links
  • DisableBalance cannot see the MultiSafepay balance
  • Uncleared can accept or decline uncleared transactions
Adding your financial email address

To add your financial email address to your MultiSafepay account, follow these steps:

  1. Sign in to your MultiSafepay account.
  2. Select the drop-down-menu in the right hand corner of your screen, next to the search bar.
  3. Click Contact details.
  4. In the Financial email field, enter the email address.
  5. Click Save.
Setting your notification URL

You can use the notification URL to automatically update an order in the backend of your ecommerce platform when you manually generate a payment link in your MultiSafepay account.

Note: If the notification URL is not correctly set, the order does not update and you may need to manually enter a URL in the Notification URL field in your MultiSafepay account.

The table below sets out example notification URLs for specific ecommerce platforms.

Plugin Notification URL
CS-Cart https://www.example.com/index.php?dispatch=payment_notification.notify&payment=multisafepay_ideal
Drupal 7 https://www.example.com/multisafepay/callback
Lightspeed https://www.example.com/index.php?dispatch=payment_notification.notify&payment=multisafepay_ideal
For more information, see FAQ - Lightspeed plugin.
Magento 1 https://www.example.com/index.php/msp/standard/notification
Magento 2 https://www.example.com/storeview/multisafepay/connect/notification
OpenCart https://www.example.com/index.php?route=extension/payment/multisafepay/callback
OsCommerce https://www.example.com/ext/modules/payment/multisafepay/notify.php
PrestaShop 1.7 http://www.example.com/module/multisafepay/validation
VirtueMart https://www.example.com/index.php?option=com_virtuemart&view=multisafepayresponse&mode=notify&type=initial&task=notify
WooCommerce https://example.com/wc-api/multisafepay_{ID-OF-PAYMENT-METHOD}?transactionid={ORDER-NUMBER}&timestamp={TIME-STAMP}
Zen Cart https://www.example.com/ext/modules/payment/multisafepay/notify_checkout.php?type=initial

Email the Integration Team at [email protected] for:

  • CCV Shop
  • Drupal 8
  • PrestaShop 1.6
  • ShopFactory
  • Shopify
  • Shopware 5 and 6
  • X-Cart
MultiSafepay app

You can download the MultiSafepay app on your:

When you click on a transaction, you can:

  • Edit the shopping cart.
  • Process full and partial refunds.
  • Change the order status to Shipped for post-payment methods.
  • Process shipments.

Feedback

Propose a change on GitHubexternal-link-icon or
send an email to [email protected]

Other languages

For an explanation in another language, contact your account manager.