Selfie Face Matching Result

Cập nhật lần cuối: 26/02/2024

API to get the selfie face matching result of the uploaded images.

Request

• Endpoint: /v1/api/ekyc-verify/result/selfie-face-matching

• Method: POST

• Header

  Name	Type	Required	Description
  api_key	string	yes	The API key associated with your account to authenticate requests (for development, check the Credentials section).

• Parameters

  Name	Type	Required	Description
  session_id	string	yes	Current session ID.

Response

• Status: 200 OK

• Body: JSON

  {
    "code": 0,
    "message": "Successful",
    "data": "<ENCRYPTED_DATA_IN_BASE64>",
    "sign": "8f4642cdb4c555f9a6d5926f4df9b73e44da2e675512d65d44c0a212",
    "request_id": "12345678"
  }

  • Field “request_id”: Request's identifier, used for auditing later.

    • Field “data”: Decrypt the “data” field as described in the Decrypt response data section to get the JSON object with following fields.

    Name	Type	Description
    status	number	The current status of the image to verify. For details, check the Appendix eKYC Status Values section.
    msg	string	Message value corresponding to the status.
    issame	boolean	Similarity of face image on ID doc and selfie image (true/false).
    prob	number	Probability of verification result (0 → 1).

    Sample Decrypted Results:

    • Result on successful matching

      {
        "prob": 0.907,
        "msg": "Successful",
        "status": 0,
        "issame": true
      }

    • Result on failed image:

      {
        "prob": 0,
        "msg": "Successful",
        "status": 0,
        "issame": false
      }

  • Field “sign”: The “sign” field is created by encrypted data and a secret key, described in the Signature section.