Connecting your payment provider

You have an account with a payment provider. Now you tell Passavo that it may use that account. That takes two minutes.

If you do not have an account yet, first go to Creating a Mollie account, Creating a Stripe account or Applying for Bancontact Pro.

What you need beforehand

• The Owner role. Only an owner reaches this screen. An Administrator does not either: whoever can switch the provider decides where the money goes. See Staff and roles.
• With Mollie: access to your Mollie dashboard, because that is where you copy your API key.
• With Stripe: your Stripe sign-in details. You sign in with them during the connection process, so keep your password and your two-step verification to hand.
• With Bancontact Pro: your API key and the knowledge of whether it is for the test environment or for production.
• Five minutes at a computer. Do not do this quickly on a phone between two meetings.

The screen

Go to Settings → Payments in the left-hand menu.

You now see three blocks one below the other: Mollie, Stripe and Bancontact Pro. Under each name is the state of play: Not connected yet, or Connected followed by

• for Mollie, the name of your profile at Mollie;
• for Stripe, the number of your Stripe account (it starts with acct_);
• for Bancontact Pro, the environment of your key: EXT or PROD.

Under the name there can be two badges: a green Active for the ticket shop on the provider your ticket shop uses, and an orange Test mode when a connection does not collect real money yet. See Test mode below.

With Stripe, is there the red sentence This provider has not been set up on the platform yet, so connecting is not possible yet. instead of a button? Then Stripe is not yet switched on in this installation. It is not a setting on your side: send a message to support. Mollie and Bancontact Pro can always be connected.

Connecting Mollie

With Mollie you paste your own API key. No signing in, nothing to approve: key in, done.

Step 1 — Copy your key at Mollie

1. Sign in to your Mollie dashboard, at mollie.com.
2. Go to Developers → API keys.
3. You see two keys there:
   • the Live API key, which starts with live_. With it your visitors really pay;
   • the Test API key, which starts with test_. With it everything runs from start to finish, but no real money changes hands.
4. Copy the key you want to use with the copy button next to it.

Which one do you choose? If you want to sell straight away and your Mollie account has been approved, take the Live API key. If you want to try everything first, or you are still waiting for Mollie's approval, take the Test API key. You can always switch later.

Note: copy the key itself, not the profile ID (pfl_…) or an organisation token (access_…). An API key always starts with live_ or test_.

Step 2 — Paste it into Passavo

1. In Passavo, go to Settings → Payments, to the Mollie block.
2. Paste your key into the Mollie API key (live_… or test_…) field. You do not see the characters as you paste; that is as it should be.
3. Click Save key.

Step 3 — Passavo checks your key straight away

Passavo asks Mollie whether the key works, before it is even saved. If everything is in order, you see the message Your Mollie key has been saved. and the block says Connected, followed by the name of your profile at Mollie. Below that is Active payment methods at Mollie, with the methods that are switched on in your Mollie dashboard — for example Bancontact, iDEAL and card. That way you see at once that you pasted the right key.

If no other provider is active yet, Mollie then becomes the active provider for your ticket shop. If Stripe or Bancontact Pro is already active, it stays active; if you want to use Mollie after all, click Use this provider with Mollie.

If the key is not right, nothing is saved and you see the message Your Mollie key has not been saved., with the reason below it. See What if … below.

Go straight on to Testing with a payment of 1 cent.

Replacing your key

Paste a new key into the same field and click Replace key. That one is checked first too; if it is refused, your previous key simply keeps working. This is how you go, for example, from your Test API key to your Live API key.

What can Passavo do with that key?

With your key Passavo starts payments for your ticket shop, your online top-ups and your payment terminal at the till, reads their status and makes refunds. The money goes straight from your visitor to your Mollie account; it is never held in an account of ours.

The key is stored encrypted and disappears from the screen after saving: nobody can read it there any more, not even you. If you think someone else knows your key, create a new one in your Mollie dashboard and paste it here with Replace key.

And the "Connect your Mollie account" button?

On some installations the Connect your Mollie account button is shown next to Save key as well. With it you connect via Mollie's sign-in screen instead of with a key. Both work; the key is the usual way. If the button is not there, you do not need it.

Connecting Stripe

With Stripe you paste no key. You give permission via their own sign-in screen.

Step 1 — Click the button

In the Stripe block, click Connect your Stripe account.

Step 2 — Sign in with Stripe

You leave Passavo and arrive on a screen of Stripe itself. Take a quick look at your browser's address bar: it should say stripe.com. That way you know you are typing your password in the right place.

Sign in as you normally do, with your two-step verification.

Step 3 — Give permission

You now see a screen listing what you are allowing. A standard connection via Stripe Connect gives access to your Stripe account. Passavo only uses it to start payments, request their status and make refunds. You withdraw it at any time with Disconnect.

If you have several accounts with Stripe, choose the right one. Then click the button that gives permission (Connect my Stripe account, or something to that effect).

Step 4 — Back in Passavo

You automatically come back to Settings → Payments, with the message The connection was successful. at the top. The Stripe block now says Connected.

A new Stripe connection immediately becomes the active provider for your ticket shop: it gets the green pill Active for the ticket shop, even if another provider was already active.

Test mode

If the orange Test mode badge is shown in a provider's block, that connection does not collect real money.

Mollie in test mode

If you saved your Test API key (test_…), your Mollie connection is in test mode. You can tell from the Test mode badge and the message This connection is in test mode in the Mollie block, and at the top of your dashboard from the red message Your shop is in test mode. During payment Mollie shows a test page where you choose yourself whether the payment succeeds.

In test mode nobody really pays, not your visitors either. An order paid that way is a test order:

• it carries a TEST marking: in the list of orders, in the confirmation e-mail, on the PDF and on the wallet pass;
• it does not count in your dashboard and is not sent as a webhook to your integrations;
• its tickets do not grant entry: the scan app refuses them;
• no invoice is issued, and a discount code or gift voucher used is not deducted.

Your visitor sees it too: your shop's checkout page says that no real payment is taking place.

Going live means pasting your Live API key and clicking Replace key. The key decides the mode: as long as your Test API key is saved, everything stays a test, even after Mollie has approved your account.

If you paste a Live API key while Mollie has not approved your profile yet, it is saved, but you see the message Mollie has not approved your profile yet. Until then Mollie refuses real payments. Use your Test API key in the meantime.

Did you connect Mollie in the past via Mollie's sign-in screen? Then that connection goes live by itself as soon as Mollie approves your profile, and the Mollie block shows a Go live button so you do not have to wait for it.

Stripe and Bancontact Pro

• Stripe gets the badge Test mode when the connection was made with Stripe's test environment. You cannot change that yourself: send a message to support. A Stripe account that has not been activated yet does not get that badge; it simply cannot accept payments yet.
• Bancontact Pro gets the badge Test mode as long as you have saved a key for the Test environment (ext). For real money you save a key for Production (prod).

Connecting Bancontact Pro

With Bancontact Pro, too, you paste a key.

1. Paste your API key into the Bancontact Pro API key field. You do not see the characters as you paste; that is as it should be.
2. In the drop-down next to it choose the environment: Test environment (ext) or Production (prod).
3. Click Save key.

If no other provider is active yet, Bancontact Pro then becomes the active provider for your ticket shop. If Mollie or Stripe is already active, it stays active; if you want to use Bancontact Pro after all, click Use this provider with Bancontact Pro. Unlike with Mollie, Passavo does not check a Bancontact Pro key when you save it: only the first payment shows whether it works. So make a test payment straight away.

Note: a key belongs to one environment. A test key in production gives error messages that seem to refer to nothing at all. So check this once too often rather than once too few.

The key is stored encrypted and disappears from the screen. If you want to replace it later, you simply paste a new one and click Replace key. That does not change which provider is active.

Which provider does your ticket shop use?

You can connect several, but your ticket shop uses one at a time. So your visitor only sees the payment methods of that one provider.

You recognise that active provider by the green pill Active for the ticket shop. If you want a different one, click Use this provider with that other one. The pill moves with it.

Existing orders stay with the provider they were paid with. A refund always goes via that provider, even if your ticket shop has since switched to another one — as long as that old provider is still connected.

The webhook URL

As soon as you are connected, a webhook URL appears in the block, something of the form https://{domein}/webhooks/mollie.

A webhook is an address the provider sends us a short message at as soon as something happens with a payment. That is how we know within a second that payment has been made, without anybody having to click refresh.

You do not have to do anything with it; that is also stated under the address: You do not need to enter this URL anywhere: we take care of that.

Provider	How the address reaches the provider
Mollie	It goes along automatically with every payment
Stripe	It is set at platform level
Bancontact Pro	It goes along automatically with every payment

Does a payment stay on Pending with you while the provider says it succeeded? Then that message has not arrived. Every incoming webhook is recorded, so that can be checked — write to us and we will look into it. See also When a payment fails.

Disconnecting

With Disconnect you break the connection. You first get a confirmation question.

What happens:

• your ticket shop can no longer start any new payments via that provider;
• with Mollie and Bancontact Pro your key is erased on our side. If you also want to make it unusable at Mollie, create a new key in your Mollie dashboard;
• with Stripe the permission is also withdrawn at Stripe itself, so that our application disappears from your dashboard;
• your existing orders stay in place, with the reference to the provider they were paid with.

If you disconnect the active provider while another one is still connected, your ticket shop uses that other one, even though the green pill is then shown nowhere. So straight away click Use this provider with the provider you want to use.

Note: do not disconnect a provider you have sold tickets with for an event that still has to take place. A refund of those orders goes via that provider. Once it is disconnected you can no longer start one from Passavo: you get the message This organisation has no payment provider connected. and have to refund in that provider's own dashboard. With Mollie you solve that by pasting the same key again.

Commonly made mistakes

Leaving the Test API key in place. With a test_ key every payment is a test, your visitors' too, and their tickets do not grant entry. Before you share your link, check that the Test mode badge has gone.

Pasting something other than the key. The profile ID (pfl_…), your password or an organisation token (access_…) do not work. A key starts with live_ or test_.

Copying only part of the key. Use the copy button in your Mollie dashboard instead of selecting the key with the mouse.

Connecting a second provider "just to try". A new Stripe connection immediately becomes the active provider. So always check afterwards whether the green pill Active for the ticket shop is on the right provider.

Thinking that connecting is enough. Which payment methods your visitor sees, you switch on in the provider's dashboard, not here.

Trying it as an Administrator. You do not even see this menu then. Ask the owner.

What if …

What if Passavo refuses my Mollie key?

Below the message Your Mollie key has not been saved. it says why:

• This does not look like a Mollie API key. You pasted something that does not start with live_ or test_, or only part of it. Copy the key again.
• This is a Mollie organisation token, not an API key. You pasted a token starting with access_. Take the Live or the Test API key from Developers → API keys.
• Mollie does not recognise this key. The key is invalid or has been renewed at Mollie in the meantime. Copy the key that is in your Mollie dashboard now.
• Mollie cannot be reached right now. Then it is not down to you. Try again in a few minutes.

In all these cases nothing is saved, and a key that was already working keeps working.

What if nothing is listed under "Active payment methods at Mollie"?

Then no payment method is switched on in your Mollie dashboard yet, and nobody can pay. Switch on at least one — Bancontact, for example — and then paste your key again so the list is updated.

What if I end up with an error message at Stripe?

If you come back with The connection was cancelled., you refused on the permission screen or closed the window. If it says The provider returned an error while connecting., try again and check with Stripe whether your account is in order.

If you get an error page instead of the Payments screen, your attempt has expired: the connection has to be completed within a quarter of an hour. Simply start again from Settings → Payments.

What if I want to switch providers in the middle of an advance sale?

That is possible. Connect the new one alongside and, if needed, click Use this provider with it. Leave the old one connected for as long as you still have tickets running from it: a refund of those old orders automatically goes via the old provider.

What if I have lost my Bancontact Pro key?

Request a new one from your bank. We cannot show it to you: it is stored encrypted and disappears from the screen after saving. The same goes for Mollie, but there you simply copy it again from your Mollie dashboard.

Frequently asked questions

Do you see my password with the provider? No. With Mollie you paste a key, not a password. With Stripe you type your password in on their own site; we only get a permission back, and you withdraw that with Disconnect.

Why a key with Mollie, and not a button as with Stripe? Because it is the quickest way and you have nothing to approve: copy the key, paste it, done. Your money reaches your own Mollie account just as directly.

Can I do the connecting on a phone? Technically yes, but do not: copying a long key or calmly reading a permission screen works better on a computer.

Can I test before I really sell? Yes, and you should. See Testing with a payment of 1 cent.

Why do I see both Bancontact Pay and Bancontact Pro? Because they are two different things. Bancontact Pro is what you apply for and connect here; that is where your key comes from. Bancontact Pay is the app your visitor scans the QR code with. Until March 2026 both were called Payconiq. See Applying for Bancontact Pro.

What happens to my tickets if I disconnect? Nothing. Tickets, orders and scans stay in place. Only new payments via that provider are no longer possible.