Duplicate Spike Alert
The "Duplicate Spike Alert" feature is designed to be a part of the Veryfi fraud prevention framework. It aims to address three primary use cases: Fraud Prevention, Abuse by a bad actor, and Developer error.
Developer Error: There is a mistake in the code that is causing API requests to be sent repeatedly in a loop. Most common and expensive case.
Fraud Prevention: Alerts on attempts to upload the same receipt/invoice to gain financial rewards.
Abuse by a bad actor: Intentional attack on your platform.
The "Duplicates Spike Alert" will trigger a series of email notifications when an excessive number of duplicate documents are submitted. By customizing the Threshold setting, you can specify the percentage of hourly volume that will trigger the alert email. Each hour, the system compares the number of duplicate documents with the total documents processed during that hour. If the number of duplicates exceeds the specified threshold, an email is automatically sent to [your account administrator email]. This allows you to take corrective action promptly if necessary.
Feature Mechanics
Duplicates Spike Alert relies on the document-level field response is_duplicate:true/false. This field comes as a part of the basic package and is enabled for all accounts by default.
Please note:
- Duplicate detection feature and Duplicates Spike Alert are currently available for Receipts&Invoices API usage, while other Endpoints might have services to flag duplicate submissions. Duplicates Spike Alert only supported for Receipts&Invoices API /documents. Refer to API Docs
- Requests parameter boost_mode skip duplicate check, so if you are sending requests with boost_mode:true The duplicate detection service will be skipped, and the alert will not be triggered. Read more about boost_mode
- Some customers might have is_duplciate field removed from their account configuration, since it affects latency or might not be applicable for some particular use case. Read more about duplicate vs similarity checks
How to know if Duplicate detection is enabled?
Veryfi Web Portal > Dashboard lists some major Setup and Settings:
You can also check out one of the recently processed documents, navigating to the JSON Tab. If you see is_duplicate field in your JSON response, it means that it is available to you.
How to enable and configure Alert?
By default, the Alert is turned off for all customers. To activate and customize the thresholds, please follow these steps.
Go to Veryfi Web Portal
Navigate to Company Settings
Scroll down to Email Notification Preferences
First, Toggle on to activate this feature
Second, configure a threshold
Threshold Customization
Users with admin rights can customize the threshold percentage. Each user with admin access will have the ability to enable/disable the alert as well as set/update the company-wide threshold. As a new threshold setting apply, the change will overwrite the previous threshold value, and the new threshold setting will then be applied company-wide. This allows for centralized management of the threshold value while providing flexibility for admins to adjust the setting as needed to meet specific requirements or adapt to changing conditions.
Duplicate Spike Alert Triggers
Every hour, the system checks the percentage of duplicates against the total volume of documents submitted for that period. As soon as the volume hits 50 documents per hour and the percentage of duplicates exceeds the threshold, an email notification is sent to the company administrator.
👩🏻🚒 Kindly be aware that this feature only becomes operational once the hourly volume of documents reaches 50. But if any customization is required, please contact [email protected].
The system should send no more than 3 emails within 24 hours. Additionally, an internal alert will be sent to [email protected], so if you have SLA plan Gold / Platinum, Veryfi support team will take action & escalate if needed.