Implementation Guideline KHQR SDK Documentation

Implementation Guideline

KHQR SDK Documentation

Version 1.8

December 2020

DOCUMENT HISTORY

Versio n

Date

Description

1.0 1.0.1

1.1 1.1.1 1.2

14.12.2020 04.01.2021

25.01.2021 01.02.2021 17.02.2021

- Alignment content. - Remove the Error Handling part. - Make all contents in Requirement, Installation and

Usage parts more consistent. - Add a timestamp to the QR code string. - Add md5 hash string to response data. - Add Bill Number, Store Label, Terminal Label in QR - Add the request parameter section.

Adding decode KHQR information function.

1.3

15.03.2021 Add Javascript SDK

- Add function to generate KHQR deeplink.

1.4

20.04.2021

- Rename decode function name from decodeQR to

decode. (iOS only)

1.5

08.07.2021

Add deeplink routing diagram

- Add merchant Id for merchant type.

- Add Acquiring Bank merchant name for merchant

type.

1.6

11.07.2021

- Add a mobile number to additional data. - Capture value of merchant city.

- Update generate KHQR function.

- Update decode response value.

- Add deeplink routing diagram.

- Update generate individual by adding new tag for

1.7

01.09.2021

account information and acquiring bank name. - Update decode function without validate on required

fields.

1.8

12.11.2021

- Make improvements on the verify function for iOS, Java and javascript.

TABLE CONTENT

Introduction

3

Overview

4

Purpose

4

Scope

4

Features

7

Requirement

7

iOS

8

Java

8

C#

8

Javascript

8

Installation

8

iOS

9

Java

9

C#

10

Javascript

12

Usage

14

iOS

16

Java

23

C#

28

Javascript

33

Deeplink Diagram

40

Standard Response

41

Response Format

41

Response Key and Code with definition

41

FAQ

43

Introduction

Overview

The standardization of KHQR code specification will help promote wider use of mobile retail payments in Cambodia and provide consistent user experience for merchants and consumers. It can enable interoperability in the payment industry. A common QR code would facilitate payments among different schemes, e-wallets and banks and would encourage small merchants to adopt KHQR code as payment method.

KHQR is created for retail or remittance in Cambodia and Cross-Border. It only requires a single QR for receiving transactions from any payment provider through Bakong including Bakong App. For more detail please refer to Prakas KHQR Code Specification in Cambodia.

Purpose

This document describes the detailed specification of how to use KHQR SDK offered by National Bank of Cambodia. The expected readers are NBC technical team and third-party technical team. This can be used as reference for any interest related to the KHQR SDK.

Scope

This document contains the complete description of the KHQR SDK specification including: Features, Requirement, Installation Guide, Usage and FAQ.

Control Version

SDK

Version

Javascript 1.0.0 1.0.1 1.0.2 1.0.3

1.0.4 1.0.5

1.0.6

1.0.7 (Latest)

iOS

0.1.1

1.0.0.1 1.0.0.2

1.0.0.3 1.0.0.4

Description

Having generate decode and verify KHQR feature

Add generate deeplink feature

- Ghost Version

- Add merchant Id for merchant type. - Add Acquiring Bank merchant name for merchant

type. - Add a mobile number to additional data. - Capture value of merchant city. - Update generate KHQR function. - Update decode response value.

- Ghost version

- Update generate individual by adding new tag for account information and acquiring bank name.

- Update decode function without validate on required fields

- Fix amount formatting

- Adding a function to check bakong account

Make improvements on the verify function.

- Add a timestamp to the QR code string. - Add md5 hash string to response data.

- Add Bill number, Store label and terminal label to QR String.

Add decode KHQR information function.

Changes on function decode khqr - Validate length and CRC - Validate each tag according to KHQR specification

................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download