Getting Started
POS Integration Guide

11min
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
﻿
﻿
Step 3: If you need updates on the order use the status api (details below)
Staging vs Live Environment
This document only covers the staging environment api's.
Please refer to ﻿https://docs.sg.latitudepay.com/sandbox-and-live-environment for production env urls.
Authorization
The api to create the dynamic qrcode requires an authorization key.
Create authorization key from merchant console following these instructions:
Include the following header:
HTTP_AUTHORIZATION: Api-Key <your public key>
Apis
How to generate dynamic QRCode
Create a QRCODe via this api
POST
Request
Header Parameters
ParHTTP_AUTHORIZATIONameter name
optional
String
<the public key>
﻿
Example Curl command
Shell
curl --location --request POST 'https://latitudepay.me/api/v2/partner/qrcode/' \
--header 'Authorization: Api-Key demo_hardcoded_public_key_btL7eqg9_fixed_my' \
--header 'Content-Type: application/json' \
--data-raw '{
  "metadata": {
      "key1":"value1",
      "key2":"value2"
  },
  "merchant": {
    "merchant_id": "",
    "store_id": "string",
    "terminal_id": "string",
    "public_key": "demo_hardcoded_public_key_btL7eqg9_fixed_my"
  },
  "bill": {
    "merchant_order_id": "67baeb37-904f-4bc8-9b31-61cf25f12c7e",
    "display_name": "Macbook Pro 2020",
    "tax_amount": 0.0,
    "total_amount": 2400.99,
    "currency": "MYR",
    "reference_id": "string",
    "pre_checkout_token": "string",
    "type": "OFFLINE",
    "version": "v2"
  },
  "customer": {
    "phone_number": "+60599625033",
    "email": "[email protected]"
  }
}'
curl --location --request POST 'https://latitudepay.me/api/v2/partner/qrcode/' \
--header 'Authorization: Api-Key demo_hardcoded_public_key_btL7eqg9_fixed_my' \
--header 'Content-Type: application/json' \
--data-raw '{
  "metadata": {
      "key1":"value1",
      "key2":"value2"
  },
  "merchant": {
    "merchant_id": "",
    "store_id": "string",
    "terminal_id": "string",
    "public_key": "demo_hardcoded_public_key_btL7eqg9_fixed_my"
  },
  "bill": {
    "merchant_order_id": "67baeb37-904f-4bc8-9b31-61cf25f12c7e",
    "display_name": "Macbook Pro 2020",
    "tax_amount": 0.0,
    "total_amount": 2400.99,
    "currency": "MYR",
    "reference_id": "string",
    "pre_checkout_token": "string",
    "type": "OFFLINE",
    "version": "v2"
  },
  "customer": {
    "phone_number": "+60599625033",
    "email": "joedoe@123fakestreet.com"
  }
}'
﻿
Response: 
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 status of the QRCode <qrcode_id> generated above
GET
Request
Header Parameters
ParameHTTP_AUTHORIZATIONter name
required
String
<your public api end point>
﻿
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
﻿
Updated 25 Mar 2024
Did this page help you?
Integration Options
Direct API integration Guide