website logo
⌘K
πŸš€Getting Started
Welcome Developers
Web integration Architecture
Integration Prerequisite
πŸ”Authentication
πŸ“ŒSandbox and Live Environment
πŸ› οΈIntegration Options
POS Integration Guide
Direct API integration Guide
βš™οΈPlugins
πŸ‡²πŸ‡ΎMalaysia
πŸ‡ΈπŸ‡¬Singapore
πŸ›οΈMarketing brand guide
πŸ”Logo introduction
πŸ–₯️Sitewide
πŸ‘—Product & service pages
πŸ‘œCheckout and cart page
🌐Website Assets
API REFERENCE
Docs powered byΒ archbeeΒ 
15min

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

  • This document only covers the staging environment api's.
  • Please refer to https://docs.octifi.com/sandbox-and-live-environment for production env urls.

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

Create a QRCODe via this api
POST
Params
Header Parameters
ParHTTP_AUTHORIZATIONameter name
optional
String
<the public key>
ο»Ώ

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 status of the QRCode <qrcode_id> generated above
GET
Params
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 16 Mar 2023
Did this page help you?
Yes
No
UP NEXT
Direct API integration Guide
Docs powered byΒ archbeeΒ 
Create QRCode