Glase Unattended Payments Service introduction

Glase Unattended Payments Service (UPS) is service that allows your unattended POS to integrate with Glase. On this page you will find information how to proceed with UPS integration.

Actors

• Glase user - Glase’s and self-service machine user
• reseller - your backend maintaining self-service machines
• Glase Unattended Payments service - Glase service that will initiate purchase process on reseller side
• Glase - Glase backend
• Glase app - Glase mobile application

Flow diagram

All starts with user scanning QR code on your unattended POS.

All above methods/services are mandatory to implement.

Flow description

1. Customer scanns QRCode placed on sel-service machine using Glase app.
2. Glase Unattended Payments service calls createPurchase exposed by reseller sending JSON with token (machine id).
3. Reseller calls sendInvoice exposed by Glase and returns the invoice reference to Glase Unattended Payments service.
4. Reservation details are presented to customer.
5. Customer confirms or cancels reservation with PIN number.
6. Glase calls notificationUrl provided in sendInvoice request.
7. Reseller calls getPaymentStatus and retrieves reservation status. If RESERVED merchants proceeds to next steps.
8. Reseller unlocks self-service machine allowing user to choose the products.
9. Customer chooses products from self-service machine.
10. Reseller calls updateInvoice exposed by Glase to change details of invoice that user will see in Glase app.
11. Reseller calls commitReservation to commit transaction with final amount.

Glase Unattended Payment Service QR code scheme

Qr code should have scheme:

HTTP://SEQR.SE/000/ups?w=merchantId&t=123456

where:

• w - merchantId sent in start-up kit (usually the same as resellerId)
• t - token (machine id) that will be passed in createPurchase request to merchant

Glase Unattended Payment Service API

At this point our Glase Unattended Payment Service API is based on one REST method - createPurchase which is required to be exposed by reseller.

createPurchase method

This method will be called by Glase Unattended Payment Service once customer scanned Glase QR Code on unattended POS. Glase Unattended Payment Service service will sent below values to reseller’s backend.

createPurchase request

URL: https://yourdomain.name.com/seqr/createPurchase
HTTP method: POST
Headers: "Accept: application/json;Content-Type: application/json;charset=UTF-8"
Body:
{
    "token": "29834231890234",
    "amount": 20.00,
    "currency": "EUR",
    "msisdn": "483344323423"
}

createPurchase response

Status Code: 200
Headers: "Content-Type: application/json;charset=UTF-8"
Body:
{
   "invoiceReferenceId":"20170315072260070"
}

Error createPurchase response

Status Code: 200
Headers: "Content-Type: application/json;charset=UTF-8"
Body:
{
   "errorCode":"SYSTEM_ERROR"
}

Possible values of error code