> For the complete documentation index, see [llms.txt](https://cth-development.gitbook.io/store-elements-for-tebex/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cth-development.gitbook.io/store-elements-for-tebex/getting-started/connecting-your-tebex-store.md). # Connecting Your Tebex Store Store Elements for Tebex needs to connect to your Tebex webstore before it can display live packages, create baskets or send customers to checkout. This guide explains where to find your Tebex API keys, how to connect them in the app dashboard and how the app detects your store type. ### What you need Before connecting Tebex, make sure you have: * Store Elements for Tebex installed on your Wix site. * An active trial or subscription for this app installation. * Access to your Tebex Creator dashboard. * Your Tebex **Public Token**. * Your Tebex **Private Key**. {% hint style="warning" %} Both the Public Token and Private Key are required. Store elements will not show live packages or create baskets until both keys are connected. {% endhint %} ### Find your Tebex API keys You can find your Tebex API keys in the Tebex Partner dashboard: Copy the following values: * **Public Token** * **Private Key** {% hint style="warning" %} Keep your Private Key secure. Do not share it publicly or paste it into frontend code, page content or public support messages. {% endhint %} ### Connect Tebex in the app dashboard Open your Wix site's dashboard and go to: **Dashboard > Apps > Store Elements for Tebex** In the **Tebex Connection** card: 1. Paste your Tebex **Public Token** into the Public Token field. 2. Paste your Tebex **Private Key** into the Private Key field. 3. Click **Connect Tebex**. The dashboard will show **Checking Tebex...** while the connection is being validated. If validation succeeds, you will see: **Connected to your Tebex Store Successfully.** The dashboard will also update the **Detected Store** card with information from Tebex. ### What happens when you connect Tebex When you click **Connect Tebex**, Store Elements for Tebex: 1. Validates your Public Token and Private Key with Tebex. 2. Fetches your Tebex webstore information. 3. Fetches your package catalog. 4. Detects the store type and customer login method. 5. Saves the connection against this Wix app installation. Both the Public Token and Private Key are encrypted before being saved. {% hint style="info" %} The dashboard may show a shortened preview of the Public Token so you can recognize the connected store. The Private Key is never shown back to you. Both are encrypted and then stored securely. {% endhint %} ### Store type detection Store Elements for Tebex uses the data we receive from your store to detect how customers should identify themselves before buying packages. The **Detected Store** card can show: * **Store**: The Tebex store name. * **Store Type**: The Tebex platform or platform type. * **Customer Login**: The login method customers will use. * **Last Validated**: When the connection was last validated. ### Customer login methods The customer login method depends on your Tebex store type. | Store type | Customer Login shown in dashboard | What customers do | | --------------------------- | --------------------------------- | ------------------------------------------------------------- | | Minecraft | Minecraft Usernames | Customers enter their Minecraft username. | | FiveM or RedM | Cfx.re | Customers sign in using the Tebex/Cfx.re authentication flow. | | Universal | None | Customers do not need to sign in before creating a basket. | | Other supported store types | Steam | Customers sign in using Steam. | ### If the store type is unknown If Tebex does not return a store type or platform value, the dashboard shows an error. This is important because Store Elements for Tebex needs the store type to choose the correct customer login flow. If this happens: 1. Check that the Public Token and Private Key are correct. 2. Confirm the keys belong to the Tebex store you want to use. 3. Click **Connect Tebex** again. 4. If the issue continues, contact support with your Support ID. {% hint style="warning" %} If the app cannot detect a store type, customer login and basket creation may not work correctly. {% endhint %} ### Sync products The **Sync Products** button refreshes the package catalog from Tebex. Use **Sync Products** after making package changes or additions in Tebex if the changed package(s) doesn't/don't update or appear automatically. When sync succeeds, the dashboard shows: **Connected to your Tebex Store Successfully.** {% hint style="info" %} Most of the time, we'll fetch live data from Tebex automatically; so you only need to use this option if there's a specific change you've made that's not appearing. {% endhint %} ### Changing Tebex keys later You can replace the connected Tebex keys at any time by entering a new Public Token and Private Key, then clicking **Connect Tebex** again. If you change Tebex stores, check your Wix site after reconnecting. Package widgets, product pages and standalone package buttons may need to be updated if they were linked to packages from the previous store. ### Troubleshooting connection issues #### The dashboard says no Tebex store is connected Add both your Public Token and Private Key, then click **Connect Tebex**. #### The dashboard says the store type could not be detected Reconnect Tebex and confirm the keys belong to the correct store. If the issue continues, contact support. #### Packages do not appear on the site Check the following: * The app installation is activated. * Both Tebex keys are connected. * The package is active in Tebex. * The package is not hidden by the widget's category or package filters. * You have refreshed the site after making changes. #### A package says it cannot be added to the basket The package may require extra information, such as variables, Discord, a gift card email or a game server selection. The customer should be asked for the relevant information, but if you're consistently running into errors, please contact support. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://cth-development.gitbook.io/store-elements-for-tebex/getting-started/connecting-your-tebex-store.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.