Angaza Nexus


Premium open-source technology for the PAYG industry.

PAYG Platforms

Do you want to support Nexus products on your platform?


To generate keycodes for Nexus devices, you need:

  1. An implementation of the Nexus Keycode encoder. We provide two open-source implementations of the keycode encoder. Check out the repositories for more details:
  2. The device’s secret key (which is set permanently when the device is provisioned)
  3. An unused message ID: In order to prevent reuse of keycodes, the device remembers each message ID it has seen. To generate a working keycode, it is necessary to generate it with a message ID that has not already been used on this device. This requires a single source of truth that keeps track of device state.

Integration Options:

Here are two options to be able to support Nexus devices on your platform.

Option 1: Use the Nexus Device Management Service

Angaza offers a complete device management service to manage all of the above for you. Using our Nexus API, your platform just needs to: Claim which units your platform will be managing For each unit, report the desired state of the device and receive the reported state of the unit (and keycode) back from our API.

The Angaza system will handle everything else, including

  1. Keycode encoder maintenance - ensuring the encoder is up to date with the latest version.

  2. Generation and management of unique unit numbers and associated secret keys. This data is maintained so it is easy to port devices between PAYG platforms (to or from your platform)

  3. Complete device state reporting and history - tracking current credit state, keycode generation, and latest message IDs per unit.

Request Nexus API access by emailing

Option 2: Integrate the Nexus encoder directly into your platform and manage device identities and state locally.

Using one of the open-source encoder implementations listed above (or writing your own according to the specification in this page and the existing implementations if you use something other than Python or Java), you can generate keycodes based on PAYG account events.

At that point, the details of device management differ considerably based on the platform and business model, but looks roughly similar to this: