website logo
Channel Docs
Merchant Docs
Navigate through spaces
Channel Docs
Merchant Docs
⌘K
Guides
🚀Quick Start
🏃‍♂️Utilizing Quick Checkout
👋Welcome to Violet's Docs
💡Concepts
🌐API Reference
✋Help
Docs powered by archbee 
4min

Connect a Merchant

Set up Violet Connect

The channel will be responsible for providing the following values that will populate and configure the onboarding experience. In these values can be configured by you in the Channel dashboard. There may be additional configuration options that will be discussed during your integration.

  • Custom Path (ex. connect.violet.io/myapp)
  • App Name
  • App Description
  • Square Logo or Icon
  • Supported Commerce Platforms List
  • More Info URL
  • Redirect URL (where the merchant should return to upon success)

Once these values have been provided to Violet they will be applied to your Violet app’s configuration. If you have these values ready you can configure them on channel.violet.io

Connecting Merchants

Once setup you can go to your selected custom path connect.violet.io/myapp then go through the setup flow.

Redirect URL

The merchant will redirect to this URL after completion of the Violet Connect flow. You can pass in custom state information as documented below.

Custom State

Using the state query string parameter you can pass a value into Violet Connect by appending that to your Violet Connect URL, for example connect.violet.io/myapp?state=sample. The passed in state will be returned to you when the merchant completes the onboarding process.

NOTE:  state should be set when linking merchants to Violet Connect, do not add the  query parameter in the Violet Channel Dashboard

As a more detailed example, if your base Violet Connect URL was connect.violet.io/myapp and you send the merchant to connect.violet.io/myapp?state=sample With your base redirect URL set as myapp.com after completion of Violet Connect the merchant will redirect to myapp.com?state=sample containing the same state or value that was passed into Violet Connect to start.





Updated 02 Mar 2023
Did this page help you?
Yes
No
UP NEXT
Violet Connect - BigCommerce
Docs powered by archbee 
TABLE OF CONTENTS
Set up Violet Connect
Connecting Merchants
Redirect URL
Custom State