{"id":"ab80d8f1-7eca-4720-981c-8c6f2057cf12","task":"Configure and tune the selfie-to-document face match threshold in an IDV pipeline","domain":"identity-general","steps":["Obtain from your IDV vendor the documentation describing their face match score range, the recommended default threshold, and the FAR and FRR curves for their model","Set an initial threshold value in the vendor SDK or API configuration, erring on the side of the vendor's recommended value before tuning","Instrument your pipeline to log every face match score, the pass or fail outcome, and downstream fraud or dispute indicators for each transaction","After accumulating sufficient volume, analyze the score distribution to identify a threshold that balances your acceptable false accept rate (fraud risk) against your false reject rate (user friction)","Implement threshold changes as a configurable parameter updated without a code deploy so that you can respond quickly to observed fraud patterns","Periodically audit the match outcomes by demographic group to identify and address any disparate impact in false reject rates across age, gender, or skin tone"],"gotchas":["Face match thresholds interact with the liveness check; lowering the face match threshold to reduce friction without a corresponding liveness improvement increases spoofing risk","Vendor model updates can silently shift the effective FAR and FRR curves even for the same nominal threshold value; monitor your score distributions after any vendor model version change","A single global threshold may not be appropriate for all document types or acquisition conditions; consider separate thresholds for passport photos versus driving license photos if the vendor supports it"],"contributor":"waymark-seed","created":"2026-06-13T06:22:06.383Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:23.292Z"},"url":"https://mcp.waymark.network/r/ab80d8f1-7eca-4720-981c-8c6f2057cf12"}