> For the complete documentation index, see [llms.txt](https://merchant-help.violet.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://merchant-help.violet.io/platform-guides/cartpanda.md).

# Cartpanda

This guide is intended for Cartpanda merchants who are connecting their store to Violet. During this process, the merchant will locate their API Token in the Cartpanda dashboard and then provide it to Violet through the Violet Connect onboarding tool. The merchant will retain full control of the created credentials and can regenerate or revoke them at any time from within their Cartpanda dashboard. *Total time for completion is around 3 minutes.*

## Step 1: Locating Your API Token

The API Token is **required** to connect your Cartpanda store to Violet. It allows Violet to sync your products, manage orders, and access store information on your behalf.

1. Log in to your Cartpanda dashboard.
2. Click your **avatar** (profile icon) in the top-right corner of the dashboard.
3. Navigate to your **Profile** or **Account Settings**.
4. Locate the **API Token** section.
5. Copy the API token value.

{% hint style="warning" %}
**Important:** Keep your API token secure. Do not share it in plain text over email or chat. If you suspect it has been compromised, regenerate it immediately from your Cartpanda dashboard.
{% endhint %}

## Step 2: Locating Your Webhook Signing Secret (Optional)

The Webhook Signing Secret enables secure verification of real-time event notifications from your Cartpanda store. If not provided, Violet will use your API Token for webhook verification instead.

1. In your Cartpanda dashboard, navigate to your **Webhook** or **Integrations** settings.
2. If you have configured a webhook signing secret, copy it and keep it available for Step 3.

{% hint style="info" %}
This secret is optional. If you have not configured a custom webhook signing secret in your Cartpanda dashboard, you can safely skip this step.
{% endhint %}

## Step 3: Provide Credentials to Violet

Once you have your API Token, return to the Violet Connect onboarding tool and enter the following:

1. When prompted for your store URL, enter the full URL of your Cartpanda store including the protocol. Example: `https://mystore.mycartpanda.com`.
2. Enter your **API Token** obtained in Step 1 in the "API Token" field.
3. *(Optional)* Enter your **Webhook Signing Secret** obtained in Step 2 in the "Webhook Signing Secret" field.

Once entered, click the **Connect** button to validate the credentials and complete the connection between your store and Violet. Violet will verify your API Token by connecting to your Cartpanda store — if the token is invalid, you will receive an error message.

If the credentials are invalid, check for:

* Spaces or other copy/paste errors in the API token
* The store URL is correct (e.g., `https://mystore.mycartpanda.com`)
* The API token has not been revoked or regenerated

Upon success you will be redirected back to the channel who first sent you to Violet.

***

### Credential Summary

| Credential             | Required | Where to Find                                                      |
| ---------------------- | -------- | ------------------------------------------------------------------ |
| Store URL              | Yes      | Your Cartpanda store URL (e.g., `https://mystore.mycartpanda.com`) |
| API Token              | Yes      | Cartpanda dashboard > Avatar > Profile / Account Settings          |
| Webhook Signing Secret | No       | Cartpanda dashboard > Webhook / Integrations settings              |

***

### Special Considerations

#### Default Currency

Cartpanda stores default to BRL (Brazilian Real). Ensure your Violet channel is configured to handle BRL if applicable.

#### Revoking Credentials

You can regenerate or revoke your API Token at any time from your Cartpanda dashboard profile settings. Revoking the token will immediately disconnect your store from Violet until a new token is provided.


---

# 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://merchant-help.violet.io/platform-guides/cartpanda.md?ask=<question>&goal=<endgoal>
```

`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.