# Anomaly Detection

The Congrify Anomaly Detection module is an AI-driven "early warning system" designed for modern merchants operating in a multi-PSP environment. By unifying fragmented data from providers, it identifies hidden revenue leaks and operational failures that traditional static reporting tools miss.

**Core Capabilities**

1. Automated Baseline Modeling: Our machine learning models automatically learn your "normal" performance patterns - accounting for seasonality, regional trends, and specific payment methods - so you only get alerted when a deviation is statistically significant.

2. Granular Attribute Monitoring: Anomalies rarely affect your whole business. Congrify pinpoints issues down to specific slices: a single issuer cluster, a specific BIN range, or a particular 3DS authentication flow behaving irregularly on one processor.

3. Unified Decline Analysis: By standardizing "Reason Codes" across all your PSPs into a single internal language, the platform can detect sudden surges in specific failure types (e.g., "Do Not Honor" or "Technical Error") across different providers simultaneously.

4. Economic Drift Detection: Beyond technical failures, the system monitors your Cost of Acceptance. It flags "economic anomalies," such as unexpected shifts in interchange categories or sudden "scheme fee" spikes that erode your margins.

**Key features of the anomaly detection capabilities in Congrify**

| Feature | Business Impact |
|--- |--------- |
| Instant Alerts | Stop waiting for end-of-month reports. Get notified the moment a gateway times out or fraud spikes. |
| No-Code Analytics | Deploy sophisticated ML monitoring without writing a single line of SQL or building an in-house data science team.|
| Root Cause Diagnostics | Don't just see the "what," see the "why." Alerts are enriched with context across attributes giving you clarity on the anomalous behaviour.|
| Revenue Protection | Identify "quiet drifts" i.e. gradual declines in performance that compound over time, before they escalate into major outages. |

## Detected Anomalies reported to you in near real-time

Anomalies found in the payment behaviour and operations can be viewed by navigating to the Anomalies → Detected Anomalies tab on the Congrify platform.

Here you will find the detected anomalies in payment operations and behaviour data, which have been classified in Critical, Read/ Unread and Resolved state, along with a list of anomalies, with brief information of the grouping  dimensions (to be read as AND conditions) and volume impact predicted in your default currency.

![Alt text](https://docs.congrify.com/Images/AnomalyDetection_1.png) 

You can further refine the anomalies detected by the KPI and timeframe when it was detected/ processed. 

![Alt text](https://docs.congrify.com/Images/AnomalyDetection_2.png)

You can deep-dive into the detected anomaly directly from the listed view by clicking on the Arrow button on the left of the Anomaly tile, which creates a drop-down showing the:

- Financial Impact i.e. the current impact in default currency, number of transactions affected, and extrapolation of the impact to annual projection; and 

- Visualization of the detected anomaly (actual value, such as the Successful Authorization Rate in the example below) vs. the baseline/ predicted performance (Expected value ± the confidence interval), as predicted by Congrifys’ anomaly detection model, relevant to the grouping dimensions (i.e. in the example shown below - anomaly detected on demo merchant account using demo payment gateway on Visa scheme, for credit-card payments in USD on the Merchants e-commerce platform, by private consumers in the USA).

![Alt text](https://docs.congrify.com/Images/AnomalyDetection_3.png)

To get a relevant human-readable synopsis of the anomaly detected, you can click on the ‘Analyze’ text, next to AI Analysis, which will summarize the predicted vs actual result gaps, highlight insightful increases/ decreases in a time-period, and provide recommendations on how to reduce the cost impact through further exploration and operational optimization.

![Alt text](https://docs.congrify.com/Images/AnomalyDetection_4.png)

For further actions on the listed anomaly, click on the '…' button to : 

- Closely monitor your KPI against similar anomalies by creating an alert, which notifies you if the KPI deviates from the baseline, including setting sensitivity thresholds, slack integrations, etc. (see also our documentation on [Alerts](https://docs.congrify.com/#/Observability/Alerts) )

- Mark the listed anomaly as read or resolved or schedule a 'snooze' for re-notification

- Explore the actual data on the KPI in the anomaly by clicking on 'Explore in analytics' which routes you to the Analytics page on Congrify, with filters automatically added (as per grouping dimensions), to create the relevant view of the actual data.

![Alt text](https://docs.congrify.com/Images/AnomalyDetection_5.png)

Example of ‘Explore in analytics’ routing to Analytics view with filters automatically added to show relevant actual successful authorization rate from the detected anomaly. 

![Alt text](https://docs.congrify.com/Images/AnomalyDetection_6.png)

## Creating and exploring Anomalies basis your dimensions

To identify and explore any anomalous payment behaviour on your Merchant data, you can navigate to the Anomalies → Anomalies Explorer tab on the Congrify platform.

![Alt text](https://docs.congrify.com/Images/AnomalyDetection_7.png)

In the ‘Anomalies Explorer', you can define your target KPI (for e.g. 'Successful Authorization Rate’, etc.) and detect anomalies across multiple dimensions as applicable to your payments data.

![Alt text](https://docs.congrify.com/Images/AnomalyDetection_8.png)

In the example below, we have selected the dimensions - Payment Method (in this case - card payment, paypal or applepay) and Merchant Account (in this case - Merchants sub-entities located in UK, FR, DE and US). Post selection of the KPI and dimensions, you can click on 'Explore' to generate the visualization (including predicted baseline trend, relative critical and warning thresholds to baseline prediction, and the actual values), aggregated tables with model predictions and actual data for the selected dimensions (which can be exported for local storage in CSV format), and with a single click ask Congrifys' AI Co-Pilot to analyse and summarise the anomaly detected and actual performance of the KPI for the selected time-frame.

![Alt text](https://docs.congrify.com/Images/AnomalyDetection_9.png)

- Series selection for visualization - You can select the ‘Series’ i.e. the combination of modeled predictions and actual data, basis the dimensions selected, for visualization.

![Alt text](https://docs.congrify.com/Images/AnomalyDetection_10.png)

## Analyse with AI Co-Pilot 

With a single click on ‘Analyze', Congrifys' AI Co-Pilot will analyse and summarize the anomaly across all series, provide micro-trend movements, root cause analysis and recommended actions to explore the data further and reduce the risk of future impact. 

![Alt text](https://docs.congrify.com/Images/AnomalyDetection_11.png)
 