Welcome to the Tamio API

our api is designed to assist developers globally in incorporating ecommerce functionalities into their business workflows, expanding customer reach, and automating processes with a straightforward api key, you gain access to a comprehensive suite of api resources spanning the ecommerce landscape to support you in troubleshooting potential challenges during integration, we provide a developer's dashboard featuring a log browsing interface this tool offers a detailed analysis of requests, received responses, and the timeline of each event furthermore, we provide webhooks for over 50 events, enabling you to leverage data within your application and establish connections to third party software transactions api docid\ cbjjrkcohourb4hvdt4ey an agile and robust headless ecommerce api, tamio transactions possess the power and flexibility to cater to diverse business requirements products docid\ gaxf8cqa3te sjlpubl7a the tamio platform offers a robust and versatile product management solution, tailored to cater to a multitude of businesses customers docid\ hkljmairitqjco9fiyavz a customer denotes an individual who has engaged with your business through various touchpoints such as checkout or api whitelabel api docid\ ga3mqvgmenzjpzpubzuye launch your very own ecommerce platform with our whitelabel program we have all the tools to manage and bill clients affiliates api docid\ vn43pnwjs 178rwdyovr3 an api for managing partners that have onboarded your affiliate programs subscriptions docid\ mgechlkhdt dwcmnbwzco tamio provides an array of billing tools to manage recurring payments, in multiple currencies and payment gateways discounts docid 1oj60a g chd33m00wflo use discounts to curtail the amount levied on an order or recurring subscription tamio offers a high degree of flexibility with discounts, allowing them to be tailored to suit any business needs invoices docid\ tita0vjo2o qrjwzslrsy invoices, representing the transactional records of purchases made by customers, are automatically generated either when a customer completes an order through the checkout flow webhooks docid\ wwbtawzdb4e39skdxamlh with more than 50 events available, tamio webhooks are an integral part of the api, enabling developers to utilise data in their apps and connect to third party software assets docid\ pa3 t3e2wdz5zmffnkve6 the assets api offered by tamio presents a cost effective and efficient solution for storing and disseminating files teammates docid\ o9qtrvqd67z7vckq3fai streamline your business operations by inviting your team members to collaborate on your tamio activities shippings docid\ t2n5h1xhgnwe2l2ud8el shipping rates within the tamio api delineate the costs associated with delivering physical products to your customers leads docid\ gspqux7tg931elqq06dh6 leads, attached to customers, are essential for lead management processes or sales conversion flows warehouses docid\ eytbinznsssjmlqersiny in the realm of tamio, a warehouse signifies a physical location of your business that dispatches products to your customers addresses docid k6btgmbdzlfglpceguu9 addresses are crucial components linked with customers, aiding in the creation of multiple billing profiles for individual customers taxes docid\ cm9gxjzdqbvkfgmed7xjo tamio offers a comprehensive tax management module, providing both automated and manual tax rate configurations exchange rates docid\ zvypnpzya2jcxb23zhit2 the exchange rates api provides access to currency conversion tools and exchange rates for all supported tamio currencies reviews docid\ bgcrnakk9mlmdpnhwww9f the reviews api offers access to all the testimonials collected from your customers api keys to start using the api, you need to generate a developer key in tamio, there are two types of keys; publishable and secret secret keys have access to all api resources ( minus transactions ) and should not be shared publicly publishable keys have access to the transactions api they can be shared inside your application and with the tamio js library for building custom checkout flows you can find your keys in the developer portal inside your dashboard login to your account at tamio com visit the developers section and browse the api keys tab click the create key button on the top right to use the api keys, include them in the authorization header of your requests using the following format bearer your api key here key permissions you have the ability to generate secret keys possessing specific permissions, allowing access to designated api resources enhancing flexibility, these permissions can be granulated to individual resource levels this implies that keys with access limited to specific customers or products can be created api logs to assist with debugging during the integration phase, the developer's dashboard features a log browsing interface this tool provides a comprehensive overview of requests, received responses, and the respective timing of each event response status codes the tamio api is organised around rest and provides standardised http response codes status description 200 the request was successful 301/302 the route has moved 400 the request was received, but it's invalid 401 there was an authentication error 403 there was an authentication error, or you do not have the required permissions to complete the action 404 the route was not found 500+ there was an error on our end please wait for some time before retrying the request response errors while integrating the api, some of your requests might fail with status 400 this means that the request was received, but it's invalid the response provides error clarifications to see why a failed request is invalid { "status" 400, "error code" 1023, "error" "the property pricing model does not have the right format " } error messages and warnings are in english the text is not standardised and might change in the future please do not rely on it for triggering functionality in your application rate limits rate limiting is a crucial aspect of ensuring the stability and reliability of the tamio api for all users by imposing limits on the number of requests that can be made within a certain timeframe, we can prevent any single user or application from overloading our servers, thus maintaining a smooth and responsive experience for everyone when the tamio api's rate limit is exceeded, the api responds with a 429 status code, indicating that too many requests have been sent in a given amount of time this response is a signal for users to reduce their request volume and wait before sending more requests strategies to handle rate limiting monitor your requests keep track of the number of requests your application is making to ensure it stays within the api's rate limits implement retry logic in case of a 429 response, implement a retry mechanism with exponential backoff this means waiting for a specified amount of time before retrying the request, and if necessary, increasing the wait time with each retry use batch methods when possible some of the most crucial methods can be batched, so try and use them when possible understanding and respecting the rate limiting policies of the tamio api is essential for developing applications that are both efficient and respectful of shared web resources by adhering to these guidelines, you can help ensure a positive experience for all users of the tamio platform release notes & api updates private beta version 2 0 (9th march 2024) after extensive internal testing, the api has been upgraded to version 2 0 rate limiting has been implemented and all the endpoints that will be available publicly have been finalised public beta is coming soon private beta version (19th july 2023) we are happy to announce that the tamio api has been finalized and it is now in private beta the team is currently testing the api, fixing bugs, and finalizing the infrastructure setup before the public beta pre beta version (26th december 2022) the tamio api is now being tested internally preparations for beta release are currently underway alpha version (26th september 2022) the tamio api is now in alpha the team is conducting an internal review and preparing for pre beta testing did you find a bug, documentation error or requirements outside the api's scope? let us know at api\@tamio com