Fraud reporting
To help prevent invoice fraud, Maventa provides functionality for reporting received invoices that are suspected to be fraudulent. Integrators can incorporate this reporting capability into their systems, allowing end users to submit fraud reports easily as part of their normal invoice-handling workflow.
The purpose of this user generated (crowd sourced) fraud warning service is to collect early signals of potentially fraudulent senders. If multiple receivers report the same company, the sender may be added to a warning list. When an invoice is received from a sender on this list, the receiving company can be notified, for example via the Detect service.
It is important to note that this reporting functionality cannot be used to dispute the invoice or refuse payment of it. Report is not automatically forwarded to the invoice sender or the authorities.
By including a “Report fraud” button in your integration, you give users an easy way to participate in fraud prevention by reporting suspicious invoices. See here for implementation details.
- Reporting is always associated with a received invoice
- When submitting a report, the user selects a reason category and provides a contact email
- The user may optionally add a more detailed description of the suspected fraud
- All required texts and translations are available via the API
Add a button or alternative action in your system that enables users to report a received invoice as suspected fraud.
The user is presented with a text explaining the feature and its purpose.
Display this informational text to users by using GET/v1/invoices/reports/definitions to get the text and translations. Available languages: EN, FI, SE, NO, DK, NL.
The user is prompted to select one or more reasons for their report from predefined categories. At least one reason must be selected.
Get the reporting categories and descriptions to display to the user using GET/v1/invoices/reports/definitions. Texts are available in EN, FI, SE, NO, DK, NL.
The user is shown a summary of the report and prompted to provide a contact email, as well as an optional description of the case they are reporting.
Submit the report using POST/v1/invoices/{id}/reports. Currently, only one report per invoice is allowed.
Parameters:
- Maventa invoice ID
- Reason category (one or more)
- Contact email (not displayed, can be used for follow-up)
- Optional: description of the suspected fraud
You can choose whether the reporting process is completed step by step or all at once, depending on what works best for your system. In either case, the following requirements should be fullfilled:
- The user must see the informational text to understand the feature.
- At least one reason category must be selected; this ensures sufficient case information and helps reduce reports based on invalid reasons.
- A contact email is required; it is not displayed elsewhere but may be used for follow-up if needed.
Get information and the status of a report for a specific invoice. For example, to show the user whether the invoice has already been reported, or to obtain the user report ID needed to delete a report.
Use GET/v1/invoices/{id}/reports to fetch reporting information for an invoice.
Allow the user to delete a report they previously submitted, for example if they no longer suspect fraud or need to make changes.
Use DELETE/v1/invoices/{id}/reports/{report_id} to remove an existing report.