GET
/
merchants
/
{merchant_id}
/
violet_connect_urls
curl --request GET \
  --url https://sandbox-api.violet.io/v1/merchants/{merchant_id}/violet_connect_urls \
  --header 'X-Violet-App-Id: <x-violet-app-id>' \
  --header 'X-Violet-App-Secret: <x-violet-app-secret>' \
  --header 'X-Violet-Token: <x-violet-token>'
[
  {
    "step": "PAYOUTS",
    "url": "<string>"
  }
]

This API lets you generate pre-formatted Violet Connect URLs that merchants can use to complete specific onboarding steps. You can request URLs for individual steps like setting up payouts, configuring commission rates, or creating a Stripe Express Account — or fetch all available onboarding links at once.

Use the step query parameter to retrieve a link for a specific part of the Violet Connect flow:

  • PAYOUTS
  • COMMISSION_RATE
  • CREATE_STRIPE_EXPRESS_ACCOUNT

If no step is provided, the API will return URLs for all steps. You can also pass an optional state parameter to include custom state information in the returned links.

This endpoint is especially useful when you want to send merchants directly into a specific part of onboarding, like immediately prompting them to select a banking country to create a Stripe Express Account.

Headers

X-Violet-Token
string
required
X-Violet-App-Secret
string
required
X-Violet-App-Id
integer
required

Path Parameters

merchant_id
integer
required

Query Parameters

step
string
state
string

Response

default - application/json

default response

The response is of type object[].