How to activate an API key and how to add/change the codes of services on Stebby?

An API key allows you to connect Stebby with your point-of-sale (POS), booking, or sales system (such as Mobi, Noom, CompuCash, Booklux, etc.).

NB! The API key can only be used on a Service Provider account with a Standard or Gold package.

How to activate the API key?

Log in to your Service Provider account.
Open Sales & Services → Points of Sale.
Select the desired point of sale and click Edit POS.
Go to the bottom of the page and enable the option API key has been activated.
Enter the name of the POS, booking, or sales system you are using (e.g., CompuCash, Noom, Mobi, Booklux…).
Click the + sign to create a new API key.
If you have already created an API key previously, we recommend adding the year to the end of the new key's name (e.g., "CompuCash 2026") to make it easier to distinguish between different keys. After successfully integrating the new key, we recommend removing the old one.
Under the Show keys button, you can see all API keys associated with your Point of Sale.

Which purchase authentication method to use?

API V4 supports two different use cases.

Token (recommended for online sales)

The token-based solution is designed for e-shops and self-service environments. The User is securely authenticated via Stebby, and the User grants your system permission to perform Stebby transactions on their behalf. As a result, the User does not need to enter their personal identification code on your website, and the Service Provider does not need to store sensitive personal data in their system.

The token solution enables:

Secure User identification;
Using Stebby funds directly in the shopping cart;
Combining a Stebby payment and an additional fee on the e-shop side, if necessary;
Avoiding manual entry of ticket codes or discount codes;

EST_PIN (for POS systems)

EST_PIN is intended for physical POS systems where the cashier looks up the customer directly from the register using their personal identification code. This functionality is not enabled by default for new API keys. If you wish to use customer lookup from your POS system, please write to us at info@stebby.eu.

How to add service codes?

After setting up the integration, the POS system's service code must be added to each service being sold.

Open Sales & Services → Points of Sale on the Service Provider account.
Click the Edit POS button next to the respective point of sale, and then click the Manage point of sale services button in the view that has opened.
Enter the code provided by the POS system into the API code field on the service line.
Make sure there are no spaces before or after the code.
Save each code individually using the green checkmark at the end of the line.

After saving the service codes, services can be sold from the POS system according to the designated codes.

How to find technical documentation?

API documentation and technical guides for developers can be found in the Stebby API documentation. If you need EST_PIN permissions or help with setup, contact us at info@stebby.eu.