Overview

This manual provides the necessary information to enable Epassi as additional tender to the default payment method in Instant Systems' kiosks. 

This feature enables users to pay using Epassi application as an optional payment method to select items on top of the traditional methods like Chip&Pin payment terminals. 

Normal interaction scenario:

1. The customer starts interacting with the kiosk using a bank card.
2. The customer scans the payment QR Code from their Epassi App on their mobile device
3. The customer picks up the merchandise
4. If the merchandise is included in the list of items included in the Epassi required/optional product, then the Epassi Benefits will be applied

5. The customer confirms the purchase and the Epassi Benefits amount will be charged to the customer's Epassi wallet and the rest if any will be charged to the customer's bank card.

    

The customer can scan their Epassi QR code at any time during the session. If kiosk fails to finalize the Epassi transaction, the benefits reduction will be removed, and the customer will have the option to return the merchandise, rescan their wallet or pay fully with the default payment method. 

When the user scans their wallet, "My Benefits" button will be visible in the header of cart page. The button opens a popup page the displays the products included in the required and optional items that can be purchased using Epassi (Note that the product will not be visible if they are currently not available for purchase in the kiosk).

If the amount to be paid using Epassi exceeds 50€ the customer will be prompted to confirm the transaction on their mobile device. Additionally, due to the limitation of Epassi system, we are unable to verify the QR code upon scanning, instead the QR in validated when the user clicks on "pay", If the QR code is invalid or expired (normally after 3 minutes) the user will be prompted to rescan their wallet before continuing.

The products that are available to be purchased using Epassi need to be configured using "Special Package Deal" See configuration section for more details. Normal package deals and subsidies will work as normal with Epassi.

Important Notice

Epassi requires all communication to Epassi systems to be signed using private and public key pairs. During the initial setup (only the first kiosk). Epassi will require you to provide the public key to get the necessary production credentials (i.e. the accesskey and POS name), the following are the public key parts the kiosk uses to communicate with Epassi during both testing and production environments. 

Production Public Key:

-----BEGIN PUBLIC KEY-----

MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqj86jhp8aTh+HSjvClYo

w7t02S12XF/MIG3ooveHBxOGfIRmzxQxs/J43XWRWr+IR0Q22jvpfL8gYy/1vbTA

ObGn7tibc9lgDfRx15r1loMKEdG5VH2frorTJ0n02qFIXR1evWRCq+fT7s+GSeid

KjxXqJzqy1AjF9dgKjwdxABXBLp9Ydm2D/B/1ihoMYlyXdQaBq3ZwL/sxCphCm8w

F4uazdaRq4zNbE88fyzKhLd66vHaToQ7GXdc+UuGcJR9pM3iNDXtoGagPWQSxFMJ

ydnN6lzMQ56Zc6dECl/61dE1syFc6KAtnRkaqndIIxeimfdu+qIpSSn4xSo4yGZt

gQIDAQAB

-----END PUBLIC KEY-----

Testing Public Key:

-----BEGIN PUBLIC KEY-----

MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAkc+grDZSXPOjipKL2vWB

IwPsC//p+YrtsGyNGmpaDpsXo9ZlYl0UPpXU2T1gsNvAmesfgdR1E/lVytRaF1l5

9A+WCHOTtTsbnza0j3MUfz407RqFY2OwNTF12Azp1leayXOWw7kStaWRMN431kgj

TSK+Y7YM7cTL3knBpNBvk1NMIXe3cdVCLoJIYoBvYPdwH43Mdw7RDS6SNni5Ls0f

MxZuEQJaCuOoRxTx/kVZ/Uu7rjUllv6oGEux0qOabZbKKyr1zt+NVZlUgiNrt33G

AA0Qj+0ITdibcQynB3yPnqtb6aZahn1QwolwRbc0Iy4HZTgf23P5L7gCSYKK7hAX

vwIDAQAB

-----END PUBLIC KEY-----

Configuration

To enable Epassi on your kiosk you need to set the following setting in Instant Admin

CardMembershipSettings

{

  "name":"pos_54531246",

  "accesskey":"7cd0d538-3a96-492c-b80d-2a0b7cc605f6",

  "testing": false

}

Special Package Deal 

To configure which meals (required items) and beverages (optional items) you need to create a package deal with the membership field set to "Epassi".

1. Login to Instant Admin and navigate to Promotion -> Package deal https://admin.instantsystems.se/#packageDeal
2. Click on "Create package deal" and fill the following field
3. Title: The title of the item visible in the cart when Epassi is being used
4. Min and max amount that is required to the benefits to be applied, this field is optional.
5. Price reduction: should be set to 100 (i.e. 100%)
6. Membership: should be set to "Epassi"

1. Next, navigate to the "Products" to set the required and optional items
2. Add two groups, the first group should be named "Required" and should include the items that are required to be in the cart to apply the benefits (i.e. Meals). The second group, named "Optional", includes the products that the benefits are applied to only if a required item is in the cart (i.e. beverages). Note that the benefits will be applied only to one of the required items (Meals), but the optional items are not limited)
3. To add items to the group, select the group then (c) check the products you wish to add to the selected group

1. Finally, click on Save to save the special package deal.

Localization

Cart Header

Epassi logo in the header need to be included in the following directory to be visible 

C:\InstantDVD\pictures\icons\epassi_logo.png

My Benefit Popup

Message Boxes