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.
Legacy integrations may also pass other query parameters through to the chosen retailer’s Link flow. Do not add email, mobile, or other PII to URLs. New integrations send customer context in the authenticated token-creation body.

​
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.