19min

POS Integration Guide

POS Integration using QRCode

Introduction

Are you a merchant partner looking to integrate octifi in your Application/POS terminal?

Looking for something else? If you are looking for a checkout experience on the web instead, then you should look at the๏ปฟ Web Integration Guide๏ปฟ

Welcome

Integrate OctiFi by integrating a dynamic qrcode within your App.

Step 1: Create a dynamic qrcode by passing a bill {} to LatitudePay api (details below). Show the qrcode on your terminal.

Step 2: Customer scans the qrcode pay using octifi App

Customer Scans the QRCode
Customer Scans the QRCode

๏ปฟ

Step 3: If you need updates on the order use the status api (details below)

Staging vs Live Environment

Authorization

  1. The api to create the dynamic qrcode requires an authorization key.
  2. Create authorization key from merchant console following these instructions:
  3. Include the following header:

HTTP_AUTHORIZATION: Api-Key <your public key>

Apis

How to generate dynamic QRCode

Get a cake by its ID
GET
Code examples
Params
Body
|
200
404
|

Example Curl command

Shell
|

Response:

  1. Note down the qrcode text (which is a deep link) to be shown as a Qrcode Text
"qrcode": "https://octifi.page.link/HZjx",

2. Note down the qrcode_id which can be used next in the status api.

"qrcode_id": "64ea6c20-f27e-487e-b11f-e0a7293ae0d1",

Status Api

We provide the status API as well to check the status of the QRCode above.

Get a cake by its ID
GET
Code examples
Params
Text
Curl
|
200
404
|

Result:

"status": "PENDING"

Keep calling the /status api until status changes to "SUCCESS".

These are valid values for status:

  • PENDING : meaning order is still pending customer payment
  • SUCCESS : customer payment is complete
  • FAILED : customer payment is failed.

Timeout in status

  • We recommend that you keep calling the status api with 5second delay for upto 10mins to 15mins (until customer has made the final payment).

๏ปฟ

WebHooks

๏ปฟ

๏ปฟ