Create routing events report

Sign in Hub
Get help
Create routing events report
Generate a CSV export of routing decisions for orders in a selected date range

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.


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 Guide
Authenticate with the Solidgate API using merchant credentials, configure request signing, and start processing live payment transactions. 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.
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.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

{
  "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,
  "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