Glossary
Terms used throughout the Teak docs.
Hover over a term with a dotted underline anywhere in these docs to see its definition.
| Term | Meaning |
|---|---|
| access token | A short-lived token your server gets from Create an access token and sends as Authorization: Bearer <token>. It expires after 5 minutes. |
| client | The business the customer is buying from. Protection is sold under a client, with that client's API keys. |
| contract | The protection on one item in an order. The API calls it a policy: webhooks send it as resource: "Policy", it's identified by policy_number, and its endpoints are under /policies/ in the Policies reference. |
| TeakOS Widget | Teak's checkout widget. It shows the protection offer, prices it for the cart, and saves the customer's choice. |
| invoice billing | How Teak bills you: for issued contracts, on your regular invoice. Teak doesn't take payment from your customers. |
| look period | The time after purchase during which a customer can void their protection, for products that have one. |
| order number | Your ID for an order, sent as reference_id when you submit it. It must be unique across your orders. |
| partner | A platform, such as a ticketing system, that sells protection for several businesses. It onboards each one as a client, using its partner keys. The API calls a partner an affiliate, with an ID like af_.... See Onboard clients. |
| premium | The price of protection for an item. |
| protection product | What Teak offers the customer, for example refund protection. |
| public key | Your pk_... key. The widget uses it in the customer's browser, and it's safe to include in your pages. |
| refund request | A customer's request to Teak for a refund under their protection. Webhooks call it a Claim. |
| secret key | Your sk_... key. Use it only on your server, with your public key, to get access tokens. |
| session | Created by the widget when it loads, with an ID the widget makes or one you pass as sessionId. It holds the quote and the customer's choice, and its ID is what you submit. It becomes the Teak order ID. |
| Teak order ID | Teak's ID for an order. For orders from the widget, it's the same as the session ID. |
Next steps
To see these terms in action:
- See how Teak works: the pieces of an integration and how they fit together.
- Follow the integration guide step by step, from sandbox to live.
Updated 19 days ago
Did this page help you?