MplusKASSA

MplusKASSA is de meest gebruiksvriendelijke en flexibele kassasoftware op de Nederlandse markt. Wij hebben een pin koppeling gebouwd zodat je met alle gemak onze Yomani ML pinterminal kan gebruiken in combinatie met jouw MplusKASSA. Deze pinbetalingen zijn real-time inzichtelijk.

Informatie

Facts
Naam	MplusKASSA
Ontwikkelaar	PAY.
Scope	Pinkoppeling, retourpinnen en QR
Transactiekwaliteit	Basis betalingsgegevens + product data
Prijs	Gratis*
INstore / PIN	Ja - volledige pinkoppeling (inclusief retourpinnen)
Checkout	(Retour)pinnen - Start betalingen via de pin. Retourpinnen is ook mogelijk QR betalingen - Genereer een QR code op het klantendisplay die met een telefooncamera gescand kan worden, deze hosted payment page beperkt zich niet alleen tot iDEAL maar geeft alle betaalopties weer die je bij de verkooplocatie hebt geselecteerd
Installatie via	Er is geen installatie nodig, je krijgt van ons een Subscription ID + endpoint URL die je in de kassa instelt
Categorie	Hosted solution
Ingebruikname	Webhooks module dient geactiveerd te zijn. MplusKASSA kan ondersteunen bij de configuratie in de kassa. PAY. ondersteunt bij het koppelen van de middleware
MplusKASSA versie	v43.2.2+
Handleiding	Zie het kopje 'Installatie' hieronder

*Wij brengen geen extra kosten in rekening voor het gebruik van deze koppeling.

De webhooksmodule dient geactiveerd te zijn voor deze koppeling. MplusKASSA kan hiervoor kosten in rekening brengen.

Installatie

Wij hebben een tussensysteem ontwikkeld om jouw PAY. account en pin terminal te koppelen aan de kassa. Hierdoor hoef je geen externe software te downloaden.

Welke informatie hebben wij van jou nodig?

MplusKASSA secret
Filiaal nummer
Werkplek nummer

Deze koppeling is geverifieerd door MplusKASSA, meer informatie vind je hierdoor ook in hun appstore:

Mogelijkheden

Naam	Betaalmogelijkheden	Omschrijving
Pinnen via PAY.		Pin + retourpinnen
Hosted Payment Page (QR)		Een QR code die wordt getoond op het klantendisplay of externe monitor. Kan gescand worden met de camera van een smartphone. Via de Hosted Payment Page zijn alle betaalmethoden beschikbaar die je hebt geactiveerd op de verkooplocatie, inclusief iDEAL

Handleiding

Deze instructies gaan ervanuit dat je de instellingen wijzigt via de kassa zelf. Wanneer je de instellingen remote wijzigt, kunnen de instructies afwijken.
De volgende gegevens zijn nodig om jouw PAY. account te kunnen koppelen aan MplusKASSA.
De koppeling bestaat uit 3 fases:

PAY. account koppelen aan tussensysteem
PAY. koppelen in de kassa
Knoppen instellen in de kassa

Fase 1 - PAY. account koppelen aan tussensysteem

Stuur een email naar partner@pay.nl met de volgende gegevens:

Onderwerp: Koppeling MplusKASSA
AT-code: [AT-code van PAY.]
SL-code: [jouw verkooplocatie binnen PAY. die je wilt gebruiken voor deze koppeling]
TH-code: [het ID van jouw pinterminal *OPTIONEEL*]
Secret token: [secret token van jouw MplusKASSA]
Filiaal nummer: [Filiaal nummer van de MplusKASSA die je wilt gebruiken voor deze koppeling]
Werkplek nummer: [Werkplek nummer van de MplusKASSA die je wilt gebruken voor deze koppeling]

PAY. koppelgegevens

Jouw koppelgegevens vind je eenvoudig onder het tabblad Beheren > Verkooplocatie. Voor volledige instructies zie het kopje koppeling maken.

MplusKASSA gegevens

Secret
Ga naar Beheer > Instellingen > Webhooks (zie afbeelding: Secret token).

Filiaal- en werkpleknummer
Het filiaal en werkplek nummer kun je op meerdere manieren vinden, waaronder:

In het Hoofdmenu bovenaan
In dit geval is het filiaal nummer 3 en werkplek nummer 1
In de kassa, rechts bovenin
Onder Beheer > Instellingen > Instellingen > Interfiliaal

Als het goed is heb je nu de volgende gegevens bij de hand:

AT-code (bijvoorbeeld: AT-1234-1234)
SL-code (bijvoorbeeld: SL-1234-1234)
TH-code (bijvoorbeeld: TH-1234-1234)
Secret token (bijvoorbeeld: as526scSkdcll23411cvKpllkm12=)
Filiaal nummer (alleen cijfers, bijvoorbeeld: 3)
Werkplek nummer (alleen cijfers, bijvoorbeeld: 1)

Deel deze gegevens met partner@pay.nl.
Dit zijn alle stappen die horen bij het koppelen van jouw PAY. account met het tussensysteem. Ga niet verder naar fase 2 totdat je van PAY. een Subscription ID hebt ontvangen.

Fase 2: PAY. koppelen in de kassa

Houd de volgende gegevens bij de hand:

Subscription ID (zoals hierboven verkregen)
Webhooks URL: https://connector-q.pay.nl/mpluskassa/webhooks

Open het hoofdmenu van jouw MplusKASSA
Navigeer naar 'Beheer'
Ga naar 'Instellingen' > Webhooks
3.1 Subscription ID: vul hier jouw subscription ID in die je van PAY. hebt ontvangen
3.2 Secret token: *dit token heb je eerder met PAY. gedeeld
3.3 Endpoint: vul hier het volgende in https://connector-q.pay.nl/mpluskassa/webhooks

De koppeling is nu gemaakt. Nu dienen we alleen de knoppen voor de betaalwijzen nog toe te voegen aan de kassa. MplusKASSA kan hierbij ondersteunen indien nodig.

Fase 3: Knoppen instellen in de kassa

De knoppen kunnen in het afrekenscherm ingesteld worden, maar ook als sneltoets. In dit voorbeeld stellen wij de knoppen in op het afrekenscherm.

Betaalwijze toevoegen

Navigeer via het hoofdmenu naar Beheer
Financieel > Betaalwijzen
Voeg betaalwijze toe:
Voor PIN > betaalwijze ID: K_PAY_PIN
Met omschrijving: PAY. PIN (dit komt op de kassa te staan als 'betaalknop')
Voor QR > betaalwijze ID: K_PAY_QR
Met omschrijving: PAY. QR (dit komt op de kassa te staan als 'betaalknop')
Voor de betaalwijze QR moet ‘QR’ in het betaalwijze ID staan (hierop filtert onze code of er een pin betaling of QR betaling gestart dient te worden)
Activeer betaalmethode voor de relevante kassa's met behulp van de vinkjes
Navigeer vervolgens naar Instellingen > Webhooks
Activeer hier de volgende events en betaalwijzen specifiek voor de Pay. betaalmethoden:
a. cancelExternalPayment (betaalwijze: PAY. PIN en/of PAY. QR)
b. pollExternalPayment (blocking/polling. Betaalwijze: PAY. PIN en/of PAY. QR)
c. requestCancelExternalPayment (blocking. Betaalwijze: PAY. PIN en/of PAY. QR)
d. startExternalPayment (blocking. Betaalwijze: PAY. PIN en/of PAY. QR)
De volgende instellingen zijn algemene kassa instellingen waar onze applicatie gebruik van maakt om te kijken of er een betaling gestart kan worden:
e. cancelPayment (blocking)
f. completeSession (blocking)
g. startPayment (blocking)
h. startSession (blocking)

Zorg dat de responsetijd in de MplusKASSA op méér dan 5000 staat (bijvoorbeeld 100,000ms). Dit om ervoor te zorgen dat de betalingen niet wordt afgekapt wanneer een klant langer de tijd neemt om te betalen aan de kassa.

Tussensysteem

Via het tussensysteem kun je verkooplocaties koppelen aan een pin terminal. Hiermee kun je dus instellen welke kassa een pin terminal kan aansturen (en welke).

Feature: in3 instore

Het is mogelijk om een QR-code te tonen op het klantendisplay, die met de in3 app gescand kan worden om de transactie af te ronden. In dit voorbeeld laten we zien hoe.

Specifieke voorwaarden voor het gebruik van in3 i.cm. MplusKASSA:
Voorwaarden voor de eindklant: klant heeft een in3 account, klant heeft de in3 app geïnstalleerd op de smartphone (met internetverbinding).
Voorwaarden voor de retailer: klantendisplay of externe monitor beschikbaar, bedrag is minimaal 50 euro.

Stap	Omschrijving
`1`	Sla producten aan op de kassa (direct, op een tafel of in een order)
`2`	Ga naar ‘afrekenen’
`3`	Op het afrekenscherm selecteer je de QR knop die je voorheen hebt aangemaakt (bijvoorbeeld: QR via PAY.)
`4`	Selecteer rechts onderin "Afrekenen"
`5`	Op het klantendisplay of externe monitor wordt een QR code getoond
`6`	De klant kan deze scannen met de camera van een mobiel apparaat: Direct met de in3 app: de transactie kan via de in3 app worden afgerond Via de camera: de algemene betaalpagina van Pay. zal openen, deze laadt alle geactiveerde betaalmethoden van de verkooplocatie in (zoals iDEAL en/of creditcard)

Betaalopties Mist u een betaaloptie? Vraag uw kassaleverancier om de mogelijkheden!

Betaalmethoden	Betaalwijze
Pinbetalingen / In-store payments *inclusief mogelijkheid tot retourpinnen
Hosted Payment Page (QR)	Via de Hosted Payment Page zijn alle betaalmethoden beschikbaar die je hebt geactiveerd op de verkooplocatie, inclusief iDEAL

31.7. Troubleshooting

Foutmelding	Oplossing
Deze webhook heeft geen goede reactie gegeven. Bekijk eventueel het logboek voor meer details	Controleer of er geen spaties/backspaces áchter de endpoint URL staat (via Beheren > Instellingen > Webhooks) Indien het event 'backgroundPoll' aan staat, schakel deze dan uit. Die is niet nodig voor de applicatie (via Beheren > Instellingen > Webhooks). Zorg dat de response tijd op minimaal 50000 ms staat
Terminal in use for max. [xx] seconds	Controleer of de startExternalPayment alléén ingeschakeld is om data op te halen (blocking (receive data)). De kolom Polling dient uit te staan (via Beheren > Instellingen > Webhooks).

FAQ

Wat zijn de voorwaarden van deze koppeling voor mij als gebruiker?

De webhook module vanuit MplusKASSA dient geactiveerd te zijn, en u dient te beschikken over een Yomani pinterminal van Pay.

Hoe maak ik gebruik van retourpinnen?

U kunt retourpinnen apart aanvragen. Klik hier voor instructies.

Hoe activeer ik credit card op mijn pinterminal

U kunt hiervoor een aparte aanvraag indienen. Klik hier voor instructies.

Hoe gebruik ik de pinkoppeling?

Pay. legt de koppeling tussen de systemen aan de hand van jouw secret token en combinatie filiaal/werkpleknummer. Vervolgens voeg je een betaalwijze toe aan de kassa, en een knop op het afrekenscherm. Dit kan voor zowel de pin als voor de QR oplossing gebruik worden. Let wel dat je voor de QR oplossing een klantendisplay nodig hebt.