Verify identity (1:1)

match proves a claimed identity: the subject says “I am CR-123”, you confirm it against their enrolled finger. It does not change stored enrollment state. See Enroll, verify, identify.

val session = sdk.createFingerprintReaderSession(reader.id)
 
val result = session.match(enrollee = "CR-123", position = 2)
when {
    result == null            -> { /* handled failure — see session.errors */ }
    result.matched            -> grantAccess(result.score)   // confirmed
    else                      -> denyAccess(result.message)  // normal non-match
}

Reading MatchResult

• matched: Boolean — whether the finger matched the claimed enrollee. false is a normal outcome, not an error.
• score: Double? — similarity score when the server returns one (higher is stronger).
• matchedPosition: Int? — which stored finger matched, if any.
• message: String? — optional server-supplied guidance.

Notes

• The subject must be enrolled and verified for that position first — match compares against stored, verified prints.
• match accepts the same optional agentId, isMinor, and attachments parameters as enroll.

Used in

• Enroll, verify, identify
• Handle failure modes