Merchant App Connections

For an app to access a merchant’s catalog, the merchant must first connect to the app. Once connected, the channel can browse the merchant’s published products and sell any active offers.

When the connection is established, Violet sends a MERCHANT_CONNECTED webhook to the app and a STORE_CONNECTED notification to the channel dashboard.

If the merchant later disconnects the app, Violet emits a MERCHANT_DISCONNECTED webhook and a STORE_DISCONNECTED notification to the channel dashboard. Apps can initiate a disconnect through the Merchant App Uninstall endpoint.

After disconnection, the app loses all access to the merchant’s catalog and can no longer perform actions. To regain access, the merchant must complete the Violet Connect flow again.

Keep in mind that a merchant can be disabled while still remaining connected to an app.

Commission Rate

The commission rate is specific to each merchant–app connection. If that connection is terminated and later re-established, a new rate is applied based on the app’s default commission settings.