Aide Caisse enregistreuse : Authentification

Free cash register

Free-cash-register.net, free online POS software since 2014

Follow Us

Cash Register Help Center

This help will guide you through the setup and usage of our point of sale cash register software.

Authentification

Accessing the API requires providing your APIKEY and SHOPID.

Quick summary: Get a token (APIKEY) + the shop ID (SHOPID), then use them to upload your data or record sales.

1) Get an auth token

Two methods:

  1. From the interface : Configuration ? Webservices (your account token is displayed there).
  2. By POST request : https://www.free-cash-register.net/workers/getAuthToken.php

1.1 POST /workers/getAuthToken.php

POST parameters

  • login — the login of your existing account
  • password — the password for your existing account

Expected JSON response (success)

{ "result": "OK", "APIKEY": "[your token]", "SHOPID": "[shop account ID]"}

JavaScript example (fetch)

const login = "mon.email@example.com";const password = "myPassword";fetch("https://www.free-cash-register.net/workers/getAuthToken.php", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ login, password })}) .then(r => r.json()) .then(data => {  if (data.result === "OK") {   console.log("Token:", data.APIKEY);   console.log("Shop:", data.SHOPID);  } else {   console.error("Auth error", data);  } });

2) With the API key you can…

  • Download your sales data
  • Download items, customers, departments, etc.
  • Enregistrer des ventes
Register now
Licence Creative Commons This document is made available under the terms of the licence Creative Commons Attribution 4.0 International (CC BY 4.0) .