Skip to main content
Legacy Content:The following content is only relevant for Legacy Canary users who subscribed to this Pagos product before December 2024.
Behind every event in Canary by Pagos is a trigger that defines when a particular metric warrants attention. In other words, you configure a trigger and when your data “trips” that trigger, Canary registers an event and alerts you of the change. You can create triggers that notify you of changes to your full data set or just specific segments of data; for example, a trigger can alert you when your aggregate approval rate decreases below a specific value, or when only your approval rate for French banks drops unexpectedly. Not sure what segments of your data you want to monitor? Try out one of our Suggested Triggers! These pre-configured triggers keep an eye on the payments data we consider vital for any commerce business.

Triggers Page

To view and manage all your existing triggers, click Triggers in the main navigation. By default, the Triggers page displays all of your triggers in a grid of cards; each card identifies the trigger’s name, the metric it monitors, and the trigger status (e.g. Active or Inactive). Narrow down the list of triggers using the filters at the top of the page:
  • Metric - View all triggers that monitor a specific metric
  • Owner - View triggers created by a specific user in your Pagos organization
  • Status - Filter for all Active or Inactive triggers
You can also search for specific triggers using the search bar at the top of your Canary Service Panel. Type a term into the search bar and Canary will automatically list only those triggers whose name contains that term. Click on a search result to view the trigger’s details.

Managing Trigger Details

Click a trigger card on the Triggers page to view that trigger’s details, including the metric it monitors, the threshold value, the evaluation time, and more. A line graph on the trigger details page demonstrates how your trigger’s chosen metric changed over the last week relative to the trigger’s threshold value. Below the graph, you’ll find a list of events created in response to this trigger; click on an event to learn more. You can take the following actions from this page:
  • Click the trigger’s status to deactivate or activate it
  • Click Edit Trigger to change any of the trigger’s details
  • Click Alerts to configure how Canary will notify you of new events
  • Click Delete Trigger to permanently delete the trigger from your Canary Service Panel

Canary Metrics

Canary can monitor the following metrics:
  • Approval Rate - The percentage of transactions processed that were ultimately approved; calculated by dividing by the total number of approved transactions by the total number of attempted transactions within a given time period
  • Approved Count - The total number of approved transactions in a given time period
  • Average Order Value - The average amount of money each customer spends per transaction; calculated by dividing the total revenue received by the total number of orders processed in a given time period
  • Chargeback Count - The total number of disputed transactions in a given time period
  • Chargeback Value - The total value of all disputed transactions in a given time period
  • Chargeback Rate - The percentage of transactions that were ultimately disputed; this metric option calculates chargeback rate using Visa’s formula (this month’s chargeback count divided by this month’s transaction count)
  • Chargeback Rate (Visa) - The percentage of transactions that were ultimately disputed; this metric option calculates chargeback rate using Visa’s formula (this month’s chargeback count divided by this month’s transaction count)
  • Chargeback Rate (Mastercard) - The percentage of transactions that were ultimately disputed; this metric option calculates chargeback rate using Mastercard’s formula (this month’s chargeback count divided by this month’s transaction count)
  • Decline Rate - The percentage of total attempted transactions declined; calculated by dividing the total number of declines by the total number of attempted transactions
  • Declined Transaction Count - The total number of declined transactions in a given time period
  • Declined Transaction Value - The total value of the declined transactions in a given time period
  • Fee Value - The total amount of fees accrued in a given time period
  • Refund Rate - The percentage of total transactions refunded in a given time period; calculated by dividing the total number of refunds processed by the total number of transactions
  • Refunded Transaction Count - The total number of refunds processed in a given time period
  • Refunded Transaction Value - The total amount of funds refunded to customers in a given time period
  • Share of Declined Count - The percentage of total declined transactions with a specific decline code; calculated by dividing the number of declined transactions with the given decline code by the total number of declined transactions. Select the decline code using the Decline Code filter.
  • Transaction Count - The total number of transactions processed in a given time period
  • Transaction Count Velocity - The period-over-period change of transaction count
  • Transaction Value - The total value of all transactions processed in a given time period

Threshold Types

Canary has three types of thresholds:
  • Simple – A simple threshold detects when your data exceeds a specific minimum or maximum acceptable value. You can customize the threshold value and specify whether you want Canary to notify you when your data falls above or below that exact value. This threshold type is a good option if you already know what good performance looks like and you’ve established specific KPIs for your business. Similarly, if you have a hypothesis about what data values are “normal” for your business, you can use simple thresholds to track and test that theory.
  • Relative Percentile – A relative percentile threshold detects when your metric deviates outside of the “typical” historical range of your data and helps you to find outliers. To calculate this range, Canary looks at the metric data from the chosen Lookback Window and identifies the 5th percentile (a value higher than 5% of the range of all values) and the 95th percentile (a value higher than 95% of all values). Any time your data drops above or below that 5%–95% middle range—depending on the trigger’s configuration—Canary will alert you.
  • Seasonal (Beta) - A seasonal threshold looks at measurements of the chosen metric over the last 90 days and models its periodic patterns and trends. Canary will then alert you when your data moves outside of the expected range given the context of expected seasonality. This threshold type is currently in Beta.