Signals
Veryfi's AI scans for signs of potential fraudulent activity. These signs act as flags, indicating specific issues. For instance, if a duplicate signal is triggered, its corresponding flag (value) will be set to True (1).
Below is the current list of signals. If you require additional signals that are not in our list then please reach out to your account manager.
| JSON Key | Purpose |
|---|---|
meta.fraud.submissions | A dictionary with volume of times this user submitted this document eg. last week, month, 2 weeks, day and 6 minutes. |
meta.handwritten_fields | A list of areas (dot notation) where handwriting was detected, e.g. line_items.1.total. Union of fully_handwritten_fields and handwritten_tampered_fields. Use len(meta.handwritten_fields) > 0 to check for any handwriting.Default inspected fields: total, subtotal, date, line_items.total, line_items.price, tax_breakdown.tax, tax_breakdown.tax_base (configurable via fraud.handwriting.enabled_fields). |
meta.fully_handwritten_fields | A list of areas (dot notation) where the value is entirely handwritten. Lower-risk signal. |
meta.handwritten_tampered_fields | A list of areas (dot notation) where a printed value was overwritten by hand. Higher-risk signal. |
meta.handwriting_detected | Boolean flag. true if any handwriting was detected on the document, including outside extraction fields. |
meta.duplicates | A list of duplicates found in the system that match this document. You can also do a len(meta.duplicates)>0 check to understand whether there are any duplicates. |
meta.fraud.pages | Contains information whether a page was taken from a LCD screen. Fraudsters often manipulate documents in Photoshop then take photos of the screen. This is that check. Loop through meta.pages and if .lcd.value is true then the x is the position where the picture is of lcd. |
JSON Object Example
"meta": {
"duplicates": [
{
"id": 191347946,
"score": 1,
"url": "https://scdn.veryfi.com/receipts/…"
}
],
"fraud": {
"attribution": "High velocity, Handwritten characters, LCD photo, Digital background, Duplicate receipt",
"color": "red",
"decision": "Fraud",
"digital_tampering_fields":[
0:"total"
1:"line_items.10.total"
2:"line_items.14.total"
],
"fraudulent_pdf":{
"font_mismatch":0
"fraudulent_pdf_creator":0
"score":0.94
"text_overlay":0.94
},
"images": [
{
"is_lcd": true,
"score": 0.96
}
],
"pages": [
{
"is_lcd": {
"score": 0.96,
"value": true
}
}
],
"score": 1,
"submissions": {
"last_2_weeks": 52,
"last_day": 32,
"last_minutes": 2,
"last_month": 67,
"last_week": 38
},
"types": ["handwritten characters", "LCD photo", "screenshot", "duplicate", "fraudulent pdf", "generated document"]
},
"handwritten_fields": [
"line_items.0.total",
"line_items.1.total"
],
"fully_handwritten_fields": [
"line_items.0.total"
],
"handwritten_tampered_fields": [
"line_items.1.total"
],
"handwriting_detected": true,
"warnings": [
{
"message": "Line item #14 has a problem. Quantity x Price != Total",
"type": "line_item_amount_missmatch"
},
{
"message": "Line item Description \"Aldi UK\nMixed BQ BQN\nAL0650\" repeats on lines 7, 8, 9",
"type": "line_item_repeats"
},
{
"message": "Subtotal for Line Items 23619.11 doesn't match subtotal on document 11857.19",
"type": "totals_missmatch"
}
]
}