KYC Service

Face Match Webhooks

The face matching service calls the integrator webhook after processing with the following sample response payload.

{
  "event": "COMPLIANCE_FACEMATCH_EVENT",
  "message": "Ok",
  "data": {
    "score": 100,
    "status": "completed",
    "id": "c61060e9-635a-5392-b39d-b1c27479d67c"
  },
}

{
  	"x-oneliquidity-signature": "9f76d08d50463789c0128e5ee6d316310064ca1afeb15f55e2dcfb5c4cc9074e",
}

Government Issued ID Check Webhooks

The integrator webhook is called with the response after processing the uploaded documents. The following is a sample of the integrator webhook response for a passport document.

{
  "event": "COMPLIANCE_GOV_ID_EVENT",
  "message": "Ok",
  "data": {
    "ageCheck": {
      "ageThreshold": 18,
      "age": 31,
      "underage": false
    },
    "country": "NG",
    "dateOfBirth": "1981-04-11",
    "docStatus": "pending",
    "documentNumber": "A223959234",
    "documentType": "P",
    "duplicateUserDetection": {
      "relatedRecords": null,
      "duplicateSignup": false
    },
    "expirationDate": "2025-02-25",
    "facematch": 100,
    "firstName": "CHUKWUMA CIROMA",
    "fullName": "CHUKWUMA CIROMA ADEKUNLE",
    "issueCountry": "NGA",
    "mapStatus": "reviewNeeded",
    "nationality": "NGA",
    "status": "completed",
    "surname": "ADEKUNLE",
    "templateMatch": true,
    "id": "c61060e9-635a-5392-b39d-b1c27479d67c"
  },
}

{
  	"x-oneliquidity-signature": "8ef268c37dbaa6b1edbfb0f38cb169527b099426b805b38f68630ff7b179fb1c",
}

Liveness Check Webhooks

The integrator webhook is called with the response after processing the selfie video. The following is a sample of the integrator webhook response for a passport document.

{
  "event":"COMPLIANCE_LIVENESS_EVENT",
  "message":"Ok",
  "data":{
    "live":true,
    "status":"completed",
    "id":"c61060e9-635a-5392-b39d-b1c27479d67c"
   },
}

{
  	"x-oneliquidity-signature": "3d76d0bf2785db721c699d6d4dd658f7505a777d6130e9462c586e4e39b95cf8",
}