Link Search Menu Expand Document

Identity management: synching customer accounts

The role of the webshop (in terms of interaction with the Spaaza API) in most integrations is similar to the POS (see integration guide), but the web store usually plays a very important role because it is leading in identity and authentication of customers. This means that if a new customer account is created in one of the Spaaza apps / clients, it is automatically created in the webshop (with a copy without authentication details / password in Spaaza). All passwords are stored in the web store, and when an authentication request comes to the Spaaza API, an authentication request is forwarded to the web store.

For a webshop this means that functionality must be built that makes requests to the Spaaza API, but also that webshop APIs must be available with which the Spaaza API can make requests such as creating / adjusting identity and authentication of customers.

To create customers in Spaaza the add-user endpoint can be used. To update a customer’s details in Spaaza the alter-user endpoint can be used.

Spaaza provides a number of interfaces to our customers through which customer accounts can be created or updated. These include:

  • Spaaza Store: a web based application that store staff can use to create and edit customer accounts in a physical store

  • Spaaza Console: a web based application that head office staff can use to create and edit customer accounts

  • Apps: consumer web and native iOS and Android applications through which customers can create an account and edit their existing account.

  • API: a third party service could be using the Spaaza API to create or edit customer details

Typical customer account flows

The diagram below shows how the typical account creation flow works when an account is created by Spaaza.

Accounts created in Spaaza

The diagram below shows how the typical account creation flow works when an account is created by the webshop.

Accounts created in Webshop

The diagram below shows how the typical account creation flow works when an account is edited by Spaaza.

Accounts edited in Spaaza

The diagram below shows how the typical account creation flow works when an account is edited by the webshop.

Accounts edited in Webshop