Kazang Pay App Versions, Keys and Switches.

Introduction

For many years there has not been major changes in the way that Kazang Pay works or the type of devices we use for Kazang Pay. This has changed for various business and technical reasons. As a result of all of these things happening at the same time and a lack of proper documentation, there are misconceptions about how all this fits together. This document will hopefully clear up these misconceptions and it is imperative that all staff understand how this operates.

KPv1 1.1.99

This is the default app version for Android 8 devices. A pre-cursor for using this version of the app is that the operating system on the device must be upgraded. This upgrade process is managed by the KMS app in conjunction with the KP v1 app. 

By default, all devices with this app version is routed via the Paycorp switch. 

There was a project whereby 500 of these older devices were upgraded and loaded with Lesaka Switch keys as a pilot to test the new KP App 2.0.40.  These 500 devices were manually routed at a merchant level via the CRM system to the Lesaka Switch by the Contracts team and the actual hardware was labeled with a Lesaka Switch sticker. 

It is very important to note that you cannot replace a device that has Paycorp Keys with a device that only has Lesaka Keys. The transactions will not go through and the vendor will get declines.

KPv2 2.0.40

This is the latest version of the Kazang Pay app and it supports the loading of BOTH Paycorp and Lesaka Switch keys. The endpoint for these devices will be captured by the Contracts Team and depending on which endpoint is selected, the correct keys will be made active. 

This version works via both the Paycorp and Lesaka Switch and has a built in component of the KMS app that manages the keys and OS updates. The KMS app CANNOT be installed as a seperate app onto these devices - an error will occur stating "Invalid APK".

Swopping or linking devices

Most older devices are routed via Paycorp. If another older device that is loaded with Lesaka keys is used to replace this device or an attempt is made to link a device with Lesaka keys to an existing Paycorp device, transactions will fail. If anyone is unsure of which keys are loaded onto devices, the Technical Support Team can check and advise.

New devices that support both sets of keys can be used to swop or link to older devices that are configured with Paycorp or Lesaka keys.

Devices that support both sets of keys cannot be used in conjunction with the KPv1 1.1.99 app. Transactions will be declined.