MultiSafepay
Connect MultiSafepay to PayLexer to accept cards, iDEAL, SEPA, wallets, and 200+ local payment methods across Europe.
MultiSafepay is a Dutch payment service provider headquartered in Amsterdam, offering an omnichannel platform with 200+ local and international payment methods. It supports cards, iDEAL, SEPA Direct Debit, digital wallets, buy now pay later, and in-person POS, with a single hosted checkout that adapts to the shopper's country and currency.
- Supported Regions (Merchant Accounts): Netherlands, Belgium, and the broader European market - view full list
- Supported Currencies: EUR, USD, GBP, CHF, SEK, NOK, DKK, PLN, CZK, HUF, RON, HRK, BGN, AUD, CAD, NZD, SGD, HKD, JPY, CNY - view full list
Supported Features
- Hosted checkout - shoppers are redirected to MultiSafepay's secure payment page
- 200+ payment methods including cards, iDEAL, SEPA, wallets, and buy now pay later
- One-time payments across 20 supported currencies
- Full and partial refunds, initiated from PayLexer or the MultiSafepay dashboard
- Real-time payment notifications for instant order updates
- Separate Test (sandbox) and Live environments
MultiSafepay supports one-time payments only. Recurring subscriptions are not available through this gateway.
Before You Start
Make sure you have:
- MultiSafepay Account – Don't have one? Sign up for MultiSafepay →
- PayLexer Account – Required to configure the integration. Create your account →
- A website where you want to integrate
Looking for a different payment processor? View all supported gateways →
Configuring MultiSafepay
You need an API Key from MultiSafepay for this integration.
Getting API Credentials
Your MultiSafepay API key is issued per website (site) in the MultiSafepay Control dashboard. The test dashboard and live dashboard each have their own key.
Log in to MultiSafepay Control
Sign in to your MultiSafepay dashboard. For sandbox testing, use the MultiSafepay test dashboard instead.
Go to Websites and add a new website
In the left sidebar under Configuration, click Websites, then click + Add new website.
Complete the details and save
Fill in the website details, then click Save.
Copy the API Key
Copy the API key shown for that website. Use the key from the test dashboard for your PayLexer Test credentials, and the key from the live dashboard for your Live credentials.
Treat your API key like a password. It authenticates payment requests and verifies incoming payment notifications - never share it publicly or commit it to source control.
Adding Credentials to PayLexer
Open PayLexer Dashboard
Log in to your PayLexer dashboard and navigate to Payment Gateways -> MultiSafepay.
Enter your credentials
Paste the API Key you copied from MultiSafepay.
Understanding Live/Production and Sandbox Settings:
| Environment | Purpose |
|---|---|
| Live / Production (Mandatory) | Used for real transactions. Cannot be empty, even when testing. |
| Test / Sandbox (Optional) | Used for testing only. No real money is processed. |
How PayLexer selects credentials:
- Debug/Test mode ON → Test credentials are used
- Debug/Test mode OFF → Live credentials are used
Test and save
Click Save to save your configuration and verify your credentials. Click Verify Connection to test the connection.
Configuring Webhooks (Mandatory)
Webhooks enable real-time payment updates and significantly improve reliability.
Benefits of Webhooks:
- Instant payment status updates
- Automatic refund processing
- Dispute notifications
With MultiSafepay, there is nothing to configure manually. PayLexer automatically registers a secure notification URL with every payment it creates, and your API Key doubles as the signing secret PayLexer uses to verify each notification is genuine.
Add a valid API Key
Confirm your MultiSafepay API Key is saved in PayLexer (see the steps above). No separate webhook secret or webhook URL is required.
Payments confirm automatically
When a shopper completes payment, MultiSafepay notifies PayLexer, which verifies the signature and updates the order to paid, failed, cancelled, or refunded - no action needed on your side.
Because notifications are what move an order to its final status, keeping a valid API Key saved in PayLexer is what makes real-time updates and automatic refunds work.
Integrate MultiSafepay to Your Website
If you have already added and configured your site, you can enable MultiSafepay in your existing setup.
Go to Websites
Navigate to Websites in your PayLexer dashboard.
Edit your website
Click the Edit Icon of your added website.
Enable MultiSafepay
Click the checkbox to enable MultiSafepay for the website.
If you haven't added a website yet, Continue to Add Your Website →
Troubleshooting
Best Practices
- Test in the sandbox before enabling production - complete a full payment with your Test API key first.
- Keep a valid API Key saved in PayLexer at all times so notifications and refunds keep working.
- Enable only the payment methods and currencies you intend to accept in your MultiSafepay account.
- Store your API key securely and rotate it in both MultiSafepay and PayLexer if you suspect it was exposed.
FAQs
Still Have Questions?
- MultiSafepay Support: MultiSafepay Support
- PayLexer Support: Contact Support