Link Search Menu Expand Document


Associated Terms
Customer, Member, Shopper, Administrator
Parameter Names Used
user_id, username, member_number, authentication_point_identifier, auxiliary_identifier

In the Spaaza data model, a ‘user’ is an object representing an individual person with an account.

User Types

Spaaza has two types of users: end-users and administrative (“admin”) users. These are described below.


An end-user is an end-customer consuming a Spaaza service - that’s to say a real-life person with an account. Examples might be:

  • An identified shopper ordering an item in a webshop
  • A customer in a retailer’s physical store
  • Someone using a Spaaza white-label retailer or customer organisation app at home
  • A member of a digitally-provided service such as a car-sharing network who’s making use of incentives available when they drive a car

End-users are always associated with a particular Spaaza retailer or customer organisation, and are often a member of a loyalty or incentive marketing programme run by Spaaza, and hence have a ‘member number’ (sometimes referred to as a ‘customer number’). It is also possible for end-users to have other identifiers, such as an ‘auxiliary identifier’ or an ‘authentication point identifier’.

Many Spaaza API endpoints are available for adding end-users, viewing and updating their properties, carrying out actions on their behalf, and deleting their accounts.

End-users are often referred to as “customers” or “members.”

Administrative (“Admin”) User

An administrative (“admin”) user is an employee or other administrative account associated with a Spaaza retailer or customer organisation. Admin users have rights to view data and carry out actions on behalf of a retailer, or on behalf of an end-user associated with the retailer. Every admin user has permissions allowing them to carry out specific actions in administrative apps Spaaza provides, such as our “Console” site, and in the Spaaza API.

Examples of admin users are:

  • A store employee logging into a Spaaza-provided “Store” site to create an end-user account for a customer
  • A head office employee logging into the “Console” admin portal to configure campaigns and check analytics for a Spaaza promotional campaign
  • A POS device in a store uploading transaction information

Admin users are treated separately from end-users. They do not take part in any campaign- or transaction-related incentive activities such as earning points, redeeming vouchers, or uploading transactions.

A Spaaza retailer normally has one or more admin users with “super user” permissions, who have the power to add, update and delete other admin user accounts.

Table of contents