MplusKASSA Integration

What is MplusKASSA?

MplusKASSA is a modular POS software platform used across hospitality, retail, leisure parks, museums, and event venues in the Netherlands, Belgium, and Germany. It supports stationary tills, kiosks, handheld terminals, and QR ordering from a single system.

For attractions and leisure venues, MplusKASSA is most commonly used to manage:

• Food & beverage outlets (restaurants, kiosks, bars)

• Retail and merchandise points

• On-site upsell services (e.g., locker hire, parking, activity add-ons)

The Convious–MplusKASSA integration connects your Convious webshop and ticketing setup with your venue's MplusKASSA tills, allowing guests to redeem pre-purchased F&B or upsell vouchers on arrival.

What the Integration Does

Voucher Redemption (Convious → MplusKASSA)

When a guest purchases a ticket bundle or upsell product in the Convious webshop — for example, a family ticket that includes a lunch deal — Convious injects a corresponding voucher into MplusKASSA via the API. The voucher is linked to the same QR code printed on the guest's ticket, so staff can scan it once at any MplusKASSA till and the correct discount or pre-paid item is automatically applied.

Example: A guest buys a "Family Day" ticket online that includes four burger meals. Convious creates a voucher in MplusKASSA for four burger menu items. When the family orders at the restaurant till, the server scans the ticket QR code and the four meals are instantly deducted — no second code, no manual lookup.

Voucher rules are flexible and can be configured to apply to:

• A specific product (e.g., a burger menu)

• A product category (e.g., all hot food items)

• A percentage discount across the full assortment

• A fixed-amount discount on the basket total

Season Pass Holder Discounts

The integration also supports member benefit scenarios. If your venue offers season passes or memberships through Convious, you can configure MplusKASSA voucher rules so that season pass holders automatically receive a discount on in-park purchases when they scan their pass at any till.

Example: A season pass holder scans their Convious pass QR code at the restaurant till and receives a 10% discount on their entire F&B order — no separate voucher code or staff intervention required.

Discount rules for season pass holders follow the same configuration options as standard vouchers: percentage discount, fixed-amount reduction, or access to a specific product or category. Work with Convious support during the product mapping step to define which membership types trigger which discount rules.

Prerequisites

Before activating this integration, confirm the following:

• Your venue is an active Convious partner with ticketing or membership products configured.

• Your venue uses MplusKASSA as your on-site POS system.

• You have a MplusKASSA account with API access enabled (this requires registering as a development partner with MplusKASSA — contact your MplusKASSA account manager to request this).

• You have a technical contact (developer or IT manager) on your team who can assist with the initial configuration and testing.

💡 Note: The MplusKASSA API uses the SOAP standard and provides a WSDL file for generating method stubs. Convious handles the integration build on our side; your MplusKASSA environment needs to be set up and accessible before development can begin. For most partners, the end-to-end process from kickoff to go-live takes approximately three weeks.

How to Get Started

Setting up the MplusKASSA integration involves a joint onboarding process between your team, Convious, and MplusKASSA. The table below summarises the key steps, who owns each, and a realistic timeframe.

Step 1: Confirm the Integration Scope

Before any technical work begins, align with your Convious Customer Success Manager on which features you want to activate:

• Voucher injection (required for F&B and upsell redemption)

• Season pass / membership discounts (if applicable)

Convious support will document the agreed scope and coordinate the next steps with our product and engineering teams.

Step 2: Register Your MplusKASSA Environment

Your MplusKASSA account manager needs to provision a test (development) environment that Convious can use during the integration build. This test environment includes access to all MplusKASSA modules and lets both teams verify the full guest journey before going live.

To request this:

1. Contact your MplusKASSA account manager and inform them that you are starting an integration with Convious.

2. Ask them to set up a development environment and provide the API credentials and WSDL endpoint to your Convious contact.

3. Share those credentials with your Convious Customer Success Manager so our team can begin the configuration.

Step 3: Map Your Products and Voucher Rules

Work with your Convious support to map your Convious ticket and membership products to the corresponding items in your MplusKASSA product catalogue. For each voucher type you want to offer, you will need to define:

• Which Convious product triggers the voucher (e.g., "Family Ticket + Lunch", or a specific season pass type)

• What the voucher entitles the guest to (e.g., four burger menus, or a 10% discount on all F&B)

• The discount type — either a fixed amount, a percentage discount, or a pre-paid item from the MplusKASSA catalogue

• Scope — whether the voucher applies to a specific product, a product category, or the entire F&B assortment

⚠️ Important: Voucher codes are injected into MplusKASSA at the point of purchase in the Convious webshop. Make sure your MplusKASSA product catalogue is finalised before going live, as changes to item names or IDs after launch may require remapping.

Step 4: Test the End-to-End Flow

Before going live, both teams must verify the complete guest journey in the test environment:

1. Purchase a test ticket with a bundled voucher through the Convious webshop (test mode).

2. Check that the voucher has been successfully injected into MplusKASSA by looking it up in the MplusKASSA back office.

3. Scan the ticket QR code at a test MplusKASSA till and confirm that the correct voucher is applied.

4. Verify the voucher status in MplusKASSA after redemption (it should show as redeemed).

💡 Note: MplusKASSA stores injected vouchers locally, so redemption works even if there is a temporary internet outage at the venue. The till does not need to call back to Convious at the point of scan.

Step 5: Go Live

Once testing is complete and both teams sign off:

1. Switch the integration from the test environment to your live MplusKASSA environment.

2. Brief your F&B and retail staff on how the voucher redemption works at the till (see the next section for a step-by-step guide you can share with them).

3. Test one real purchase before your opening day to confirm everything is working end-to-end in production.

Convious support and the MplusKASSA team will remain available for support in the shared Discord channel during and after your go-live.

Voucher Redemption: How It Works for Staff

When a guest presents their ticket at an F&B till, the process is straightforward:

1. The guest shows their Convious ticket QR code (printed, email, or digital wallet).

2. The till operator scans the QR code using the MplusKASSA scanner.

3. MplusKASSA automatically looks up the linked voucher and applies the discount or pre-paid items to the order.

4. The operator confirms the order and the guest pays any remaining balance (if applicable).

The QR code on the Convious ticket is the same code used for entry — guests do not need a separate voucher code.

Monitoring and Troubleshooting

Checking Voucher Status

If a guest reports that their voucher is not being accepted at the till, your team can look up the voucher status in MplusKASSA:

1. Open the MplusKASSA back office.

2. Navigate to the voucher management section and enter the ticket QR code or order reference.

3. Check whether the voucher has been received, is still valid, and has not already been redeemed.

Common reasons a voucher may not scan:

• The voucher was not successfully injected (check the Convious order in the back office for errors)

• The voucher has already been redeemed

• The ticket QR code has been damaged or is unreadable

For voucher injection errors, contact your Convious Customer Success Manager or raise the issue in the shared MplusKASSA Discord channel.

Error Messages

MplusKASSA error messages at the till are prefixed to indicate which system is responsible. If an error references "Convious" or contains an order or ticket ID, it relates to the Convious side of the integration — pass this to your Convious CSM. If the error is a generic MplusKASSA system message, contact MplusKASSA support directly.

💡 Note: Convious logs all voucher injection calls, including timestamps, order references, and response codes from MplusKASSA. If an issue needs investigating, your CSM can pull these logs to identify exactly where in the flow a problem occurred.

FAQ

Which MplusKASSA modules are required for the integration? The voucher injection feature uses the standard MplusKASSA SOAP API — no additional modules are required beyond a standard MplusKASSA licence with API access enabled.

Can guests use their voucher at any till in the venue? Yes. Vouchers are stored in the MplusKASSA database and are accessible from all connected tills in the venue. Guests can redeem at any MplusKASSA terminal, regardless of which outlet they visit.

What happens if a guest loses their ticket or the QR code is damaged? Convious can reissue the ticket from the back office. Once the new QR code is issued, the linked voucher in MplusKASSA remains valid and will be accessible via the new code.

Is this integration available in Germany and Belgium? The integration works wherever MplusKASSA is deployed. MplusKASSA is currently active in the Netherlands, Belgium, and Germany. Note that MplusKASSA's fiscal compliance features — such as TSS certification in Germany — are handled entirely within MplusKASSA and are not affected by the Convious integration.

Does Convious support partial voucher redemption? This depends on how the voucher rules are configured in MplusKASSA. Vouchers can be set up to apply to a specific product, a product category, or a basket-level discount. Partial redemption (e.g., using two of four pre-paid items across separate visits) is possible if configured accordingly — discuss your specific use case with your Convious CSM during the product mapping step.

How long does the integration take to set up? For most venues, the end-to-end process from initial kickoff to go-live takes approximately three weeks: roughly one week for the Convious engineering build, one week for joint testing, and buffer time for product mapping and environment provisioning on the MplusKASSA side.