Submetering industry terms and vocabulary

There are 14 entries in this glossary.
Search for glossary terms (regular expression allowed)


Term Main definition

A Vending operation or Vending transaction may be any one where a credit token is generated for a meter. This includes a normal sale, FBE token issue, Free token (if supported), and Credit Transfer token. This specifically excludes Engineering tokens and Key Change tokens. See Credit Token, FBE Token, Engineering Token, Meter Credit Transfer Token and Key Change Token

Vend Information Sources

Vend Information is the information that is required to Vend a Token. This information is typically stored on the Meter Database and also on the Meter Card but all these sources of information are not always available

Vending Channel

Any method that a consumer may use to make payment and, as a result, receive a credit token that can be used to top-up a meter.

Vending Client

The Online Vending Machine that issues the Token to the Operator. The Vending Client does not have the capability to create a prepaid Token; it must request tokens from the Vending Server via XMLVend protocol. See Vending Server, Gateway, Client and Vending Terminal.

Vending Client Server

The term has been discontinued due to confusion caused This has now been replaced by the term Gateway. See Vending Gateway, Vending Server, Vending Client and Vending Terminal

Vending Float

A amount paid to us by a Vendor in order to secure the amounts vended.

Vending Gateway

The Vending Gateway is an intermediary device for a Gateway Vendor. For such a Vendor all the Vend requests will be passed to the Server via this Gateway and similarly the Server will return all the responses to the Gateway. Behind the Gateway, the Vendor may have many proprietary Vending Terminals of different capabilities but all of that is transparent to Eskom since the Terminals never communicate directly with the Eskom Server. Refer to Gateway Vendor for more information on this. See Vendor Type, Gateway Vendor and Vending Terminal

Vending Terminal

A Vending Terminal is vending device that usually has a proprietary design and communication. It operates similar to a Vending Client but may also have other dedicated functions that would be transparent to Eskom. A Vending Terminal does not communicate directly to the Server but all communication is instead routed via the Vending Gateway. See Vending Gateway, Vending Client.


One of the typical Vendor Roles The term Vendor may also refer to the vending entity in general, e.g. Shoprite, EasyPay, and the owner of a Spaza shop, may all be referred to as Vendors. See Vendor Role, Vendor Category, Operator, Vendor Type and Vending Client Type

Vendor Certificate

This certificate is generated on the Online Vending CA for every Vendor once the contract has been agreed between the Vendor and the Utility. The certificate identifies the specific vendor by the Utility issued EAN number (ClientID) and ensures that all communication with the Vending Server is secured via TLS and this certificate. The Certificate does not directly identify the Vending Client although the Vendor (that will get the Vending Commission) is registered against all his Vending Clients on the Vending Server. Since the Vendor Certificate is stored on separate hardware, the Vendor may remove it and carry it with him. It is theoretically possible that the Vendor can insert the Certificate into another Vending Client and Vend from that Client. In that Case the Vending Server will still identify the Vendor correctly and deduct the credit from the correct Vendor Account. Similarly, the commission will also be calculated for this same Vendor Account. See Vendor, Vending Client Type, Vendor Role and Security Authority