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 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 sandbox and live environment 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 https //docs sg latitudepay com/integration prerequisite#f9 get your merchant keys include the following header http authorization api key \<your public key> apis how to generate dynamic qrcode example curl command 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 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