Connection URL

One of the returned fields in the connection object from the Create a Connection endpoint is the link_url, which is a unique, stable link that you can send to a business for Business Authentication.

The link_url points to the Rutter Link web app, which handles the authentication flow for each Ecommerce platform. Once the merchant completes the Link authentication flow, a CONNECTION_UPDATED event will be fired to your Webhook URL , and you will be able to fetch data for their store through this Connection.

There are a few query parameters that you can specify to a connection URL to customize the authentication experience. Here are some examples:

Loads the authentication flow directly to the Wix-specific step:
https://link.rutterapi.com/connection/123?platform=wix

Loads the authentication flow directly to the Wix-specific step and on completion the merchant will be redirected to Google:
https://link.rutterapi.com/connection/123?platform=wix&redirect_url=https%3A%2F%2Fwww.google.com

Query Parameter	Example Value	Description
platform	SHOPIFY	If `platform` is specified, the Rutter Link flow will start directly at the authentication process for the specified platform, skipping the screen for choosing the platform. See Commerce Platforms and Accounting Platforms for the respective ENUM values.
redirect_url	https://www.google.com?q=customparameter	If `redirect_url` is specified, the merchant will be redirected to the URL specified, and a `public_token` query parameter for the connection will be added to this url. If the value is `https://www.google.com?q=customparameter`, the final URL will be `https://www.google.com?q=customparameter&public_token=PUBLIC_TOKEN` This value must be encoded properly in UTF-8 format
shopifystore	example	if `shopifyStore` is specified, the Shopify authentication screen will be pre-filled with the store URL. If the value is `example`, Rutter Link will show `example.myshopify.com`

Query Parameter

Example Value

Description

platform

SHOPIFY

If platform is specified, the Rutter Link flow will start directly at the authentication process for the specified platform, skipping the screen for choosing the platform. See Commerce Platforms and Accounting Platforms for the respective ENUM values.

redirect_url

https://www.google.com?q=customparameter

If redirect_url is specified, the merchant will be redirected to the URL specified, and a public_token query parameter for the connection will be added to this url. If the value is https://www.google.com?q=customparameter, the final URL will be https://www.google.com?q=customparameter&public_token=PUBLIC_TOKEN

This value must be encoded properly in UTF-8 format

shopifystore

example

if shopifyStore is specified, the Shopify authentication screen will be pre-filled with the store URL. If the value is example, Rutter Link will show example.myshopify.com