Introduction
Getting Started
- Apps
- Pagination
- Authentication
- Environments
- Definitions
Checkout
- Overview
- Getting Started
- Merchants
- Catalog
- Carts and Bags
- Discounts
- Webhooks
- Guides
- FAQs
- Resources
- Current Platforms
Payments
- Overview
- Payment Integrations
- Payment Settings
- Setup
- Payments during Checkout
- Payouts
- Webhooks
Violet Connect
- Overview
- Setup
- Payouts
- Commissions
- Guides
- Testing
- FAQs
Relay
Product Info
FAQs
When will Violet be able to provide full integration with Squarespace?
Violet is limited to supporting the API features that are provided by the ecommerce platform. Squarespace currently has limitations in checkout orchestration, particularly with cart and shipping data.
The timeline for cart and shipping data from Squarespace is entirely dependent on if/when Squarespace chooses to expand their offering.
Violet’s integration with Squarespace still supports order creation, merchant onboarding, synced product catalogs, and order update webhooks.
How do I connect a new merchant to my app?
You can view a step-by-step guide and a video example here
How do I disconnect a merchant from my app?
You can disconnect a merchant from your Channel by using the Request Merchant App Uninstall endpoint.
How do I let my merchant change the email they used for Violet Connect Onboarding?
To prevent issues of “dead emails” we highly recommend that merchants use a group based email address that multiple people have access to when initially setting up their accounts. violet.merchant@companydomain.com for example. We recommend adding this to you onboarding procedures as a recommendation to pass on.
Currently we have a manual process on Violet’s end that allows us to accomplish this task, however there are a few security related considerations.
- The new email must be @companydomain.com. To avoid scams, we cannot transfer a merchant to gmail.com email address or any other public email provider.
- The merchant cannot yet have setup their payout account; this is to prevent financial fraud. You can check this in the Merchants tab, if the
Payout Accountis marked “Needs Attention” they have not yet created their account.- For cases where a payout account exists, we may require the merchant to complete additional verification steps before we can complete a transfer.
We have a project in our backlog to support merchants transferring ownership themselves, but for now it will be a manual process.
Assuming they fulfill the above conditions, to complete this process we will need from you:
- The MerchantId and Name
- The original email used (optional but useful)
- The desired new email (must meet above conditions)
- A screenshot of their payout account tab, to verify the above conditions. Make sure the merchant name and Id is visible in the shot.
Contact us with the above information and we will take a look.
Why is the ‘Write Customers’ permission required during onboarding?
Write Customers allows the order to be associated with a customer record in their system. This comes with things like their email, etc. Most Merchants want to make sure that data is carried through, and in order to do that, we have to be able to Write Customers as a part of the Order Creation process in their system.
We’ve historically requested this scope. Shopify did eventually give us the ability to write customers under the write_orders scope however we’ve continued requesting the write_customers scope for forwards compatibility. On July 1st Shopify will be rolling out a new suite of customer protection rules that will impact API functionality and having the write_customers scope ensures that there will be no disruptions to our integration with Shopify when this goes into effect. We will likely revisit our scopes once we’ve reached July 1st. If it’s safe to do so we can likely reduce this scope down to read_customers.
We prefer to over-optimize on scopes as asking all merchants to go back and change their scopes after onboarding has been a painful experience in the past. If the merchant is not comfortable with write_customers, they could complete the onboarding in Violet Connect, get past the scope validation part, then go back into their Shopify Custom Apps view and uncheck the write_customers scope. We don’t write any customers during that brief window that we have the write_customers scope so there will be no impact on their system. If we find that we require the scope once Shopify’s changes go into effect on July 1st we can then explain the need for it to the merchant and ask them to re-enable the scope for write_customers.
Where can my merchant see their payouts?
Merchants have access to the same distributions exports as channels.
Merchants can also view their payout on Stripe’s Stripe Express Dashboard.
- Have the merchant go to https://merchant.violet.io/settings/payments
- They will need to login with the email they created their merchant with originally
- Press the “Go to Stripe” button
- They will be directed to the Stripe dashboard
- They will need a text code from the phone number provided during setup
- Once on the dashboard, they can click on the transactions tab to see payments from violet as well Stripe Payouts to their bank account
- They can filter by date and export the data to CSV
What does the Channel Login Detected message mean?
If you see the Channel Login Detected dialog, that means that an account with the entered email already exists in Violet as a channel account. An account (email) cannot be both a merchant and a channel.
If you are a channel and you are trying to create a test store, you must use a different email address for the test merchant. Adding +merchant before the @ is often an easy way to accomplish this as the email will still go to the same inbox. E.g. joe+merchant@company.com
If a real merchant encounters this issue, that almost certainly means they accidentally created a channel account instead of following the Violet Connect flow to connect to your channel. In this case they will need to select a different email account to complete their Violet Connect flow.
If they are adamant that they want to use the already used email for Violet Connect, please contact Violet Support and explain that a merchant accidentally created a channel account and they want their email address made available to be used for their merchant account. Please provide the email address in question.
Was this page helpful?
- When will Violet be able to provide full integration with Squarespace?
- How do I connect a new merchant to my app?
- How do I disconnect a merchant from my app?
- How do I let my merchant change the email they used for Violet Connect Onboarding?
- Why is the ‘Write Customers’ permission required during onboarding?
- Where can my merchant see their payouts?
- What does the Channel Login Detected message mean?