VKYC face match

POST

https://api-dev.myemipay.com/application/vkyc/face-match

Last modified:2026-09-28 06:34:55

VKYC face match

Description: compares the live selfie with the portrait on the ID.

Usage: right after liveness returned live: true. Does not move the journey step.

Details: body { selfie, idImage }, both base64 JPEG/PNG. Returns { matched, similarity }. similarity is 0–100. matched is true when the score is 70 or higher. A missing face on either image comes back as a low score, not a crash.

Next: when matched is true, continue the loan steps already on the journey (bank, sign, auto-debit, payout).

Auth: Authorization: Bearer {{accessToken}}

Errors: 401 unauthorized | session_expired · 404 not_found · 422 validation_failed | provider_failed

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Faces match

application/json

Bodyapplication/json

🟠401Unauthorized

🟠422Photos required

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.myemipay.com/application/vkyc/face-match' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{}'

Response Example

200 - Faces match

{
  "matched": true,
  "similarity": 91
}

Modified at 2026-09-28 06:34:55

VKYC liveness check

Webhooks