View routing
List, search, export, and open routing configurations in Hub or through the API
List routing configurations in Hub or through the API. Filter by channel, payment method, and status, search by configuration, route, and step IDs, or export the full published route tree for audit and replication.
Send a request to the
list routing configurations
API v2
endpoint.
- Filter by payment_method_group with EQ : CARD , DIGITAL_WALLET , or MERCHANT_MANAGED_NETWORK_TOKEN . Include channel_id for multi-channel keys.
- Paginate with next_page_token . Omit it on the first request.
- Pass id and latest_published_version_id to get routing configuration API v2 or get routing configuration version API v2 .
On the configuration list, filter by Channels, Payment method, and Statuses:
Active
,
Inactive
,
Archived
. Archived configurations stay hidden until you include
Archived
in the status filter.
Search by routing entity supports these types:
- Configuration ID
Unique identifier for a routing configuration. - Configuration version ID
Identifier for a specific configuration version. - Route ID
Unique identifier for a route. - Step ID
Unique identifier for a routing step.
These entities are also available in the View routing event log.
To view routing entities on the configuration list
- Go to Orchestration > Configurations.
- Navigate to a configuration list page.
- In the routing entity search field, enter a configuration ID, configuration version ID, route ID, or step ID as described beside this list.
- Configuration
Opens the latest published version of the configuration in a new window. - Configuration version
Opens that specific version in a new window. - Route
Opens the version that contains that route in a new window. The route is centered and highlighted for easy identification. - Step
Opens the version that contains that step in a new window. The step is shown in the drawer and highlighted.
- Go to Orchestration > Configurations.
- Find the routing configuration and click on it.
- Navigate to a specific configuration version page.
- In the routing entity search field, enter a configuration version ID, route ID, or step ID as described beside this list.
- Configuration version
Opens here and highlights when it is the current version. Otherwise opens in a new window and highlights. - Route
Centers and highlights the route in the current version, or opens the matching version in a new window. - Step
Opens in the drawer and highlights in the current version, or opens the matching version in a new window.
Search by params filters routes on a configuration version page by condition parameters.
To search routes by condition parameters
- Go to Orchestration > Configurations.
- Click Search by params.
- Open Search for routes where and add conditions:
- Condition parameter.
- Operator offered for that parameter.
The default is Contains all.
- One or more values.
- Between rows, set AND or OR.
- Click Search and apply to see how the results are shown.
- Show only matching
Other branches collapse or hide. A banner can note that only selected branches are shown. - Highlight matches
Matching routes stand out. Other branches stay visible but de-emphasized. Use Show all or Deselect all to reset.
Export routing configuration
Track routing configuration returns the full route tree for a version. Use it to audit changes, copy logic across environments, or store an external snapshot of published routing.
To track the latest published version when a routing configuration changes, set up routing configuration events first, then retrieve the version through the API.
- Set up credentials API v2 and webhook endpoints.
- When a routing configuration version is published, receive the routing configuration version published Webhook notification.
- From the webhook payload, use
data.routing_config.idas config_id anddata.routing_config.latest_published_version_idas the version id . - Send a request to the get routing configuration version API v2 endpoint with config_id and id .
The response includes the full route tree with route sets, rules, segments, and cascade steps for the specified version.
To track a routing configuration version
- Go to Orchestration > Configurations.
- Find the routing configuration and click on it.
- Navigate to the configuration version you need.
- In the Configuration details section, click on Export.
Looking for help? Contact us