Legacy Link URLs - Subtotal Docs

Static Link URLs are deprecated and will be removed in a future release. Use customer Link tokens instead. Existing links continue to work for now.

Overview

Each retailer’s legacy Link URL launches Subtotal Link for that retailer. This page documents existing integrations, not the recommended setup for new ones.

subtotal link

Query parameters

Existing static URLs accept the following query parameters. Customer Link tokens also support redirect_url; send customer context in the authenticated token-creation body instead.

Parameter	Description	Example
`customer_id`	A unique identifier used to map connections to customer records across external systems.	`8a46e581-48ba-498a-9ad0-2ee72582e1af`
`redirect_url`	The URL that customers should be redirected to after successfully linking their account.	`https://example.com/profile`
`connection_id`	The identifier of an existing connection (used to reauthenticate a connection or reconnect an account).	`01KFCQJPY9GN5BBB8ERHEWAZ7J`

Redirects include a subtotal_link_result indicating how the attempt ended. Here’s an example of a complete Link URL that includes customer_id and redirect_url:

https://link.subtotal.com/tWGE4TJM
  ?customer_id=8a46e581-48ba-498a-9ad0-2ee72582e1af
  &redirect_url=https%3A%2F%2Fexample.com%2Fprofile