The report lists routing decisions for orders in a selected period. Each row covers selected and skipped steps, 3DS decisions, and the connector account used.

Use it to investigate performance, debug processing, and confirm that configurations behave as expected. Unlike track routing configuration, this export does not return the route tree.


API Use the Routing events API v1 report for order-level routing data: configuration and version, route and step details, 3DS decisions, and the selected connector account.

Routing events data is unloaded using the created_at parameter by default, reflecting the most recent updates to the records.
To create a report

  1. Make a routing events API v1 request with date range parameters date_from and date_to .
  2. Receive the report URL report_url in the response.
  3. Download the report in CSV format using the report_id from the URL and authorization credentials.
Use the same authorization credentials with publicKey and secretKey to download the report.

Since the report is prepared asynchronously, it may take some time to become ready for download. If the report is not ready, the API reference returns the corresponding status code:

  • 200 - authentication failure. Double-check your access to the Solidgate API.
  • 204 - report is not yet ready. Wait a little longer for it to be generated.
  • 302 - redirect to a one-time S3 download report link.
  • 404 - report was not found.
  • 410 - report is unavailable, expired.

Please note that the report is only available for 30 days from its generation date. After that period, it is no longer accessible. Hub To create a routing events report

  1. Go to Reports and exports.
  2. In the top-right corner, click on +Create report.
  3. In the pop-up window, fill in the required details:
    • Select the Routing events report type
    • Select one or multiple channels
    • Define a date range of up to 36 days
    • Optionally, modify the auto-generated file name
  4. Click on Create.
    Once confirmed, reports are generated for each selected channel.
  5. Click on Download to save and access the report.

order_id string

Description

Order identifier defined by the merchant.

Example

923bb4e6-4a5f-41ec-81fb-28eb8a152e55

psp_order_id string

Description

Order identifier generated by Solidgate.

Example

psp_order_1samrzwv8my

provider_payment_id string

Description

Payment identifier returned by the external provider.

Empty when connector_id is solidgate_acquiring.

Example

charge_64789DFS3827563HGF56

provider_transaction_id string

Description

Transaction identifier returned by the external provider.

Empty when connector_id is solidgate_acquiring.

Example

5019d00bb70f82cd42f6bc654cbdfcbd63a9b5b1dbd6a

provider_transaction_status string

Description

Transaction status reported by the provider for the routing step.

  • created - the transaction has been created
  • processing - the transaction is being processed
  • verify - the transaction is awaiting verification (such as 3DS)
  • success - the transaction completed successfully
  • fail - the transaction failed

Example

success

provider_transaction_error_code string

Description

Error codes Guide returned by the provider for a failed transaction.

Can be null.

Example

3.08

configuration_id string

Description

Identifier of the routing configuration applied to the order.

Example

cfg_01HV9Z2K3M4N5P6Q7R8S9T0U1V

configuration_version_id string

Description

Identifier of the specific configuration version that processed the order.

Example

cfgv_01HV9Z2K3M4N5P6Q7R8S9T0U1V

configuration_name string

Description

Human-readable name of the routing configuration.

Example

EU cards routing

version integer

Description

Sequence number of the configuration version applied to the order.

Example

5

payment_method_group string

Description

Payment method group the routing configuration applies to.

  • card
  • digital_wallet
  • merchant_managed_network_token

Example

card

route_id string

Description

Identifier of the route within the configuration version.

Example

rt_01HV9Z2K3M4N5P6Q7R8S9T0U1V

route_name string

Description

Human-readable name of the route.

Example

Visa EU

analytics_route_id string

Description

Stable analytical route ID.

Persists across versions until the route changes, then regenerates. For merchant analytics over time.

Example

art_01HV9Z2K3M4N5P6Q7R8S9T0U1V

is_default boolean

Description

Indicates whether the order matched the Default branch of the rule preset.

Example

false

is_default_recurring_strategy boolean

Description

Indicates whether the recurring payment was processed using the default recurring routing strategy.

Routing sets this flag when it applies the Default Recurring Strategy configured on the Connector Account instead of a matched token configuration route.

Example

false

precondition_type string

Description

Type of rule preset the route belongs to.

  • block_payments - the route blocks matching payments
  • force_3ds - the route forces 3DS authentication
  • google_pay_pan_only - the route applies to Google Pay PAN payments only
  • any - the route applies to payments not covered by other presets

Example

force_3ds

step_number integer

Description

Sequence number of the step within the route, starting with 1 for the primary step.

Example

1

step_id string

Description

Identifier of the routing step.

Example

stp_01HV9Z2K3M4N5P6Q7R8S9T0U1V

analytics_step_id string

Description

Stable analytical step ID.

Persists across versions until the step changes, then regenerates. For merchant analytics over time.

Example

ars_01HV9Z2K3M4N5P6Q7R8S9T0U1V

analytics_segment_id string

Description

Stable analytical ID for a split group.

Persists across versions until the cascade changes, then regenerates. For merchant analytics over time.

Example

arc_01HV9Z2K3M4N5P6Q7R8S9T0U1V

is_smart_route boolean

Description

Indicates whether the route splits segment traffic automatically. Smart routes redistribute traffic across segments instead of using fixed percentages.

Example

true

step_skip_reason string

Description

Reason a routing step was skipped. For the full list of values, see the step skip reason reference above.

Empty when the step was selected for processing.

Example

SKIP_CONNECTOR_ACCOUNT_DEACTIVATED

is_force_3ds boolean

Description

Indicates whether 3DS authentication was forced for the step.

Example

true

force_3ds_reason string

Description

Reason 3DS was forced. Values follow the Force 3DS preset branches:

  • antifraud
  • sca
  • client
  • external_mpi
  • custom_rule
Empty when is_force_3ds is false.

Example

sca-regulation

force_3ds_exemption string

Description

Exemption applied to 3DS authentication, such as a low-value or TRA SCA exemption.

Empty when no exemption was applied.

Example

low-value

processing_method string

Description

Processing method applied at the step.

  • card - card payment
  • network_token - network token payment
  • psp_token - PSP token payment
  • cof - card-on-file payment
  • digital_wallet - digital wallet payment

Example

card

descriptor string

Description

Descriptor used for the transaction at the step.

Example

google.com

connector_account_id string

Description

Identifier of the connector account selected for the step.

Example

ca_01HV9Z2K3M4N5P6Q7R8S9T0U1V

connector_account_name string

Description

Human-readable name of the connector account.

Example

Acquirer EU - Visa

connector_id string

Description

Identifier of the connector that processed the step.

Example

solidgate_acquiring

Routing event example 
{
  "order_id": "923bb4e6-4a5f-41ec-81fb-28eb8a152e55",
  "psp_order_id": "psp_order_1samrzwv8my",
  "provider_payment_id": null,
  "provider_transaction_id": null,
  "provider_transaction_status": "success",
  "provider_transaction_error_code": null,
  "configuration_id": "cfg_01HV9Z2K3M4N5P6Q7R8S9T0U1V",
  "configuration_version_id": "cfgv_01HV9Z2K3M4N5P6Q7R8S9T0U1V",
  "configuration_name": "EU cards routing",
  "version": 5,
  "payment_method_group": "card",
  "route_id": "rt_01HV9Z2K3M4N5P6Q7R8S9T0U1V",
  "route_name": "Visa EU",
  "analytics_route_id": "art_01HV9Z2K3M4N5P6Q7R8S9T0U1V",
  "is_default": false,
  "is_default_recurring_strategy": false,
  "precondition_type": "force_3ds",
  "step_number": 1,
  "step_id": "stp_01HV9Z2K3M4N5P6Q7R8S9T0U1V",
  "analytics_step_id": "ars_01HV9Z2K3M4N5P6Q7R8S9T0U1V",
  "analytics_segment_id": "arc_01HV9Z2K3M4N5P6Q7R8S9T0U1V",
  "is_smart_route": true,
  "step_skip_reason": null,
  "is_force_3ds": true,
  "force_3ds_reason": "sca-regulation",
  "force_3ds_exemption": null,
  "processing_method": "card",
  "descriptor": "google.com",
  "connector_account_id": "ca_01HV9Z2K3M4N5P6Q7R8S9T0U1V",
  "connector_account_name": "Acquirer EU - Visa",
  "connector_id": "solidgate_acquiring"
}

Looking for help? Contact us Stay informed with Changelog