API & Whitelabeling



From the engineering standpoint, KOOS is just another RESTful API to be integrated with your product offering. The detailed instructions are available in our  API documentation , but at glance, the process to go through is as follows.



Create a test program. For this you need access to  app.koos.io . If you do not have access, please contact your project manager to receive an invitation to your email.

Generate a test API key, unlocking API access to all programs created in TEST mode.

Use the test API key to grant virtual shares via the call to REST API, similar to the following example that issues 1 virtual share to email  email@example.com .

If you use the above example, replace the placeholders for {programId} and {apiKey} with what you created in the first two steps.

Implement error handling based on the details in the  API documentation .

Invest as much as necessary to solidify integration by making the call asynchronous and adding support for buffering and retries.

Test according to the quality criteria that any other external integration of your service would require.

Create a live program and live API key as you did in steps 1 and 2 for test mode.

Ensure that configuration management does not expose API keys and that proper secret management is used.

Go live and enjoy, not forgetting to inform the operations team about the new dependency that has been introduced.



Our engineering team will help you find the best API set-up, that fits your virtual share plan needs.



The average integration is usually done in 1-3 calendar days.



 Here are some of our client examples, who are using KOOS whitelabeling feature on their app or platform:



Whitelabel Examples