# Violet Connect for Merchants

This guide walks you through connecting your e-commerce store to Violet Connect. You will complete this process yourself — your channel cannot do it on your behalf.

## Before You Begin

Have the following ready before starting:

* A store on a supported e-commerce platform (Shopify, BigCommerce, etc.)
* Your store credentials (API keys, tokens, etc.) — see your [platform guide](https://merchant-help.violet.io/) for what you'll need
* A bank account for payout setup
* Your agreed commission rate with the channel

{% hint style="success" %}
Use a team or mailing list email address (e.g. `team@yourcompany.com`) to create your merchant account. This keeps access manageable if the person who originally set it up leaves the company.
{% endhint %}

## Steps

1. **Enter your email address** to create your Violet merchant account. Use this same email to access your dashboard at [merchant.violet.io](http://merchant.violet.io).

   ![Violet Connect Login](/files/zdWNkKD2s6GwIZEvvICR)
2. **Select your e-commerce platform.** Choose the platform your store is hosted on. Each platform has different credential requirements.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Shopify merchants who have been pre-registered by their channel may skip this step automatically.</p></div>

   ![Violet Connect platform selection screen](/files/BpZQ766HgSPIkwrbN31B)
3. **Enter your store URL.**

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Pre-registered Shopify merchants: your store URL will be pre-filled.</p></div>

   ![Store URL entry screen](/files/Rfg9KUZgKyI9ZJtjXPyx)
4. **Enter your store credentials.** Your [platform guide](https://merchant-help.violet.io/) shows where to find these in your store admin.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Shopify merchants:</strong> If you were pre-registered, you'll see a "Connect to Shopify" button instead. When installing the app, leave "Embed app in Shopify admin" unchecked.</p></div>

   ![Credential entry screen](/files/BzkpPpqjCgyWfbgvap2x)
5. **Set up your payout account.** Select the country your bank account is in. You'll be routed to Stripe to connect your account and complete identity verification.

   ![Payout account setup screen](/files/UwUEN0pImRnPa7xLS0v9)

   Learn more: [Stripe KYC Guide](/prism/payments/payouts/guides/stripe-kyc-guide.md)
6. **Select your commission rate.** This rate applies to orders placed through the channel's app and should match what you've agreed on with them.

   ![Commission rate selection screen](/files/ZxSSulYPnKpKGzrWZtAb) ![Commission rate set selection screen](/files/n7sn93k6b1H3FpWjcqb4)
7. **You're all set!** You'll be redirected to the channel's app to start selling.

   ![Completion screen](/files/TbkkPCRbVubPFzemdMij)

## Troubleshooting

**"Store URL Already Connected"** — If you need to update your credentials, sign in with the same email address you used when you first connected your store.


---

# Agent Instructions: 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:

```
GET https://docs.violet.io/prism/violet-connect/guides/violet-connect-for-merchants.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
