Skip to main content
The /select?client_id=… URL is deprecated and will be removed in a future release. Use customer Link tokens instead. Existing links continue to work for now.

​
Overview

Each Link URL launches Subtotal Link for one specific retailer. The retailer-selection URL is a hosted page that shows customers every retailer your program supports — under your brand’s name and icon — and lets them choose which account to connect. Picking a retailer starts the standard Subtotal Link flow for that retailer. Nothing else about the linking experience changes: the customer sees the same consent and login screens, and lands on your redirect_url after a successful connection.

​
URL format

​
Query parameters

URL-encode the redirect_url value — especially when it carries query parameters of its own.
The selector opens the chosen retailer’s Link URL with redirect_url and the existing connection_id, when found. To create new connections with customer details, use an authenticated customer Link token.

​
What your customers see

The page lists the retailers configured for your program, each as an identical option. When a customer picks one:
  1. The standard Subtotal Link flow for that retailer begins — consent, then the retailer login.
  2. If the customer_id you passed already has a connection for that retailer, it is reused automatically instead of creating a duplicate — picking an already-connected retailer simply re-links it.
  3. After a successful connection, the customer is redirected to your redirect_url (or shown the standard success screen if you didn’t provide one).
The page never displays connection status — every retailer looks the same regardless of whether the customer has linked it before.