POS Integration using QRCode

Introduction

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

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.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

Example Curl command

Response:

1. Note down the qrcode text (which is a deep link) to be shown as a Qrcode Text

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

Status Api

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

Result:

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