Last update: June 2023
In order to make authorized requests to Cova APIs, you must supply an access token to each request. This request below will allow you to use the access credentials you received in your onboarding package to get or refresh an access token.
https://accounts.iqmetrix.net/v1/oauth2/token
"grant_type": "password", "username": "Username given to you in the Onboarding Package", "password": "Password from your Onboarding Package", "client_id": "Client Id given to you in the Onboarding Package", "client_secret": "Client Secret given to you in the Onboarding Package"
The Access Token is valid for 43200 seconds (about 12 hours). You will need to re-generate an access token after every 12hours
Please email apisupport@covasoftware.com
to request an integrator id for you and we will be able to generate one for you, please be sure to include whether you will use this integrator id for online or in-store orders and the company name and integrator.
Prior to Cova POS version 1.5.x there were no incoming order notifications directly on the POS devices themselves. As of this version, dispensaries can choose to enable order notifications (both visual and auditory). The support document which outlines this process can be accessed by Cova businesses here: Online Order Notifications. There is no integrator work required to enable order notifications, they will occur automatically if the dispensary has them enabled.
At this time the logic for purchase limits exists only on the point of sale itself. If an order is submitted that is over the purchase limit for that market, the user of the POS will be notified in app. We are working toward providing purchase limit validation endpoints for integrators but they are not available yet.
Not at this time.
500 Server Errors are typically the result of a server-side timeout, but can occur for a variety of reasons, and tend to be slightly more common with Bulk API Calls.
Integrator's code should handle non-sucess status codes (400+) and implement retries. Often issues are transient and can be resolved by trying later.
In the event that you encounter a 500-level error in your interaction with the API, please contact us at apisupport@covasoftware.com
describing the error, please include all the API endpoints with body parameters etc.
In this case, please verify if your credentials are working correctly, you could do this by calling our API authentication endpoint or by signing into https://hub.covasoft.net/
If you are able to log in or generate an access token that means your credentials are correct and you will have to contact your integration partner. If not, please contact us at apisupport@covasoftware.com
please include your credentials in the ticket.