Docs
Developer Hub

Step Completed: Q to Z

Suggest Edits

re-facematch

Step Completed

"step" : {
  "status" : 200, 
  "id" : "re-facematch", 
  "error" : null
},

Step Error

"step" : {
  "status" : 200, 
  "id" : "re-facematch", 
  "error" : {
    "type" : "VALIDATION_ERROR", 
    "code" : "422", 
    "message" : "Parameters validation error!"
  }
},

"step" : {
  "status" : 200, 
  "id" : "re-facematch", 
  "data" : {
    "currentSelfiePhotoUrl" : "http://media-server/media/selfie/xxx.png", 
    "currentSelfieVideoUrl" : null, 
    "facematchScore" : 0.049, 
    "previousSelfiePhotoUrl" : "http://yyy.jpeg", 
    "previousSelfieVideoUrl" : null, 
    "previousVerificationId" : "<previous verification ID>"
  }, 
  "error" : {
    "type" : "StepError", 
    "code" : "facematch.differentPerson", 
    "message" : "There are different persons on photos"
  }
}

"step" : {
  "status" : 200, 
  "id" : "re-facematch", 
  "error" : {
    "type" : "StepError", 
    "code" : "facematch.noSuitableBiometricsFound", 
    "message" : "Previous suitable biometrics inputs were not found."
  }
}

"step" : {
  "status" : 200, 
  "id" : "re-facematch", 
  "error" : {
    "type" : "StepError", 
    "code" : "node.failed", 
    "message" : "Cannot meet dependent node"
  }
}

salvadorian-tse-validation

Step Completed

"step" : {
  "status" : 200, 
  "id" : "salvadorian-tse-validation", 
  "error" : null, 
  "data" : {
    "documentNumber" : "00000000-0", 
    "fullName" : "JOHN DOE", 
    "city" : "SAN MIGUEL", 
    "state" : "SAN MIGUEL", 
    "address" : null
  }, 
  "documentType" : "national-id"
}

Step Error

"step" : {
  "status" : 200, 
  "id" : "salvadorian-tse-validation", 
  "error" : {
    "type" : "StepError", 
    "code" : "salvadorianTse.fullNameMismatch", 
    "message" : "Full name mismatch"
  }, 
  "data" : {
    "documentNumber" : "00000000-0", 
    "fullName" : "JOHN DOE", 
    "city" : "CHALATENANGO", 
    "state" : "CHALATENANGO", 
    "address" : null
  }, 
  "documentType" : "national-id"
}

"step" : {
  "status" : 200, 
  "id" : "salvadorian-tse-validation", 
  "error" : {
    "type" : "StepError", 
    "code" : "salvadorianTse.notEnoughParams", 
    "message" : "Document number is not defined"
  }, 
  "documentType" : "national-id"
}

"step" : {
  "status" : 200, 
  "id" : "salvadorian-tse-validation", 
  "error" : {
    "type" : "StepError", 
    "code" : "salvadorianTse.notFound", 
    "message" : "User not found"
  }, 
  "documentType" : "national-id"
}

"step" : {
  "status" : 200, 
  "id" : "salvadorian-tse-validation", 
  "error" : {
    "type" : "StepError", 
    "code" : "salvadorianTse.notValidParams", 
    "message" : "Not valid params"
  }, 
  "documentType" : "national-id"
}

System Error

"step" : {
  "status" : 200, 
  "id" : "salvadorian-tse-validation", 
  "error" : {
    "type" : "SystemError", 
    "code" : "system.internalError", 
    "message" : "Internal error"
  }, 
  "documentType" : "national-id"
}

selfie

Step Completed

"step" : {
  "status" : 200, 
  "id" : "selfie", 
  "data" : {
    "selfiePhotoUrl" : "http://media-server/media/selfie/XXXX.jpeg"
  }, 
  "error" : null
}

Step Error

"step" : {
  "status" : 200, 
  "id" : "selfie", 
  "error" : {
    "type" : "StepError", 
    "code" : "input.failed", 
    "message" : "Cannot meet dependent input"
  }
}

"step" : {
  "status" : 200, 
  "id" : "selfie", 
  "error" : {
    "type" : "StepError", 
    "code" : "node.failed", 
    "message" : "Cannot meet dependent node"
  }
}

"step" : {
  "status" : 200, 
  "id" : "selfie", 
  "data" : {
    "selfiePhotoUrl" : "https://media.getmati.com/file?location=XXX"
  }, 
  "error" : {
    "type" : "StepError", 
    "code" : "selfieFraudDetection.fraudAttempt", 
    "message" : "Selfie is considered as fraud attempt"
  }
}

"step" : {
  "status" : 200, 
  "id" : "selfie", 
  "data" : {
   "selfiePhotoUrl" : "https://media.getmati.com/file?location=XXX"
  }, 
  "error" : {
    "type" : "StepError", 
    "code" : "selfieFraudDetection.negligence", 
  "message" : "Selfie is considered as negligence"
  }
}

"step" : {
  "status" : 200, 
  "id" : "selfie", 
  "data" : {
    "selfiePhotoUrl" : "https://media.getmati.com/file?location=XXX"
  }, 
  "error" : {
    "type" : "StepError", 
    "code" : "selfieFraudDetection.tampered", 
    "message" : "Selfie is considered tampered"
  }
}

System Error

"step" : {
  "status" : 200, 
  "id" : "selfie", 
  "data" : {
    "selfiePhotoUrl" : "http://media-server/media/selfie/XXXX.jpeg"
  }, 
  "error" : {
    "type" : "SystemError", 
    "code" : "system.internalError", 
    "message" : "Internal error"
  }
}

template-matching

Step Completed

"step" : {
  "status" : 200, 
  "id" : "template-matching", 
  "error" : null
}

Step Error

"step" : {
  "status" : 200, 
  "id" : "template-matching", 
  "error" : {
    "type" : "StepError", 
    "code" : "templateMatching.noMatchFound", 
    "message" : "Document did not match any valid template"
  }
}

"step" : {
  "status" : 200, 
  "id" : "template-matching", 
  "error" : {
    "type" : "StepError", 
    "code" : "node.failed", 
    "message" : "Cannot meet dependent node"
  }, 
  "documentType" : "custom-cadastro-nacional"
}

System Error

"step" : {
  "status" : 200, 
  "id" : "template-matching", 
  "error" : {
    "type" : "SystemError", 
    "code" : "system.serviceUnavailable", 
    "message" : "Service unavailable"
  }
}

"step" : {
  "status" : 200, 
  "id" : "template-matching", 
  "error" : {
    "type" : "SystemError", 
    "code" : "system.internalError", 
    "message" : "Step timeout"
  }, 
  "documentType" : "national-id"
}

verification_updated

{
  "resource": "https://api.prod.metamap.com/v2/verifications/6605ad9ca7f8a3001c529ae2",
  "identityStatus": "verified",
  "matiDashboardUrl": "https://dashboard.getmati.com/identity/6605ad9ca7f8a3001c529ae1/verification/6605ad9ca7f8a3001c529ae2",
  "status": "reviewNeeded",
  "eventName": "verification_updated",
  "flowId": "65fe08b6e38a18001d4ca62d",
  "timestamp": "2024-03-28T17:50:48.212Z"
}

verification_expired

{
  "resource": "https://api.prod.metamap.com/v2/verifications/6556634353fa5f001cfe4649",
  "eventName": "verification_expired",
  "flowId": "6554d6c3a21e51001c68250a",
  "timestamp": "2023-11-16T19:16:02.598Z"

video-agreement

Step Completed

{ 
      "status": 200, 
      "id": "video-agreement-validation", 
      "data": { 
        "agreement": { 
          "language": "ES-MX", 
          "minimalSimilarity": 100, 
          "script": "I, Enrique Blanco, confirm that the information captured in application number 
6450 is correct and that this is the email address where I wish to receive my policy, as well as its 
information" 
        }, 
        "recognizedSpeech": { 
          "transcript": "and I cannot go conservative information captured an application number 9999 
is not correct at which is not allowed dress registry safe as well as information", 
          "similarity": 68 
        }, 
        "publicUrls": { 
          "selfieUrl": "<http://molecules.dev-26/media/selfie/507877c6-6125-4f9c-918e-
beda1d0dc74c.jpeg>", 
          "videoUrl": "<http://molecules.dev-26/media/video/a30c0cc1-209a-4089-ad01-
75f8e98981ff.mkv>" 
        }, 
        "recognizedVideo": { 
          "faceMask": false, 
          "numFaces": 1 
        } 
      }, 
      "error": null 
    }

Step Error - No Face Detected

{ 
  "eventName": "step_completed", 
  "step": { 
    "status": 200, 
    "id": "video-agreement", 
    "data": { 
      "videoUrl": "https://media.getmati.com/file?location=hash", 
      "spriteUrl": null, 
      "selfieUrl": null, 
      "textMatching": { 
        "transcript": "I, Tania Jafet Soto González, confirm that the information captured in 
application number 6450 is correct and that this is the email address where I wish to receive my 
policy, as well as its information", 
        "originalText": "I, NAME, confirm that the information captured in application number 
NUMBER is correct and that this is the email address where I wish to receive my policy, as well as 
its information", 
        "similarity": "85.23447" 
      } 
    }, 
    "error": { 
      "type": "StepError", 
      "code": "videoConsent.noFace", 
      "message": "No face was found in the user's video" 
    } 
  }, 
  "resource": "https://api.getmati.com/v2/verifications/5ffdb056f2c321001beb4963", 
  "timestamp": "2021-01-12T14:22:36.604Z" 
}

Step Error - Text Mismatch

{ 
  "eventName": "step_completed", 
  "step": { 
    "status": 200, 
    "id": "video-agreement", 
    "data": { 
      "videoUrl": "https://media.getmati.com/file?location=hash", 
      "spriteUrl": "https://media.getmati.com/file?location=hash", 
      "selfieUrl": "https://media.getmati.com/file?location=hash", 
      "textMatching": { 
        "transcript": "I, Tania Jafet Soto González, confirm that the information captured in 
application number 6450 is correct and that this is the email address where I wish to receive my 
policy, as well as its information", 
        "originalText": "I, NAME, confirm that the information captured in application number 
NUMBER is correct and that this is the email address where I wish to receive my policy, as well as 
its information", 
        "similarity": "20.177" 
      } 
    }, 
    "error": { 
      "type": "StepError", 
      "code": "videoConsent.textMismatch", 
      "message": "There are significant differences between the expected text and wahat the user 
said " 
    } 
  }, 
  "resource": "https://api.getmati.com/v2/verifications/5ffdb056f2c321001beb4963", 
  "timestamp": "2021-01-12T14:22:36.604Z" 
}

voice

Step Completed

"step" : {
  "status" : 200, 
  "id" : "voice", 
  "data" : {
    "videoUrl" : "http://media-server/media/video/XXX.qt", 
    "text" : "7-6-8", 
    "selfiePhotoUrl" : "http://media-server/media/selfie/XXX.jpeg", 
    "spriteUrl" : "http://media-server/media/selfie/YYY.jpeg"
  }, 
  "error" : null
}

Step Error

"step" : {
  "status" : 200, 
  "id" : "voice", 
  "error" : {
    "type" : "StepError", 
    "code" : "input.failed", 
    "message" : "Cannot meet dependent input"
  }
}

"step" : {
  "status" : 200, 
  "id" : "voice", 
  "data" : {
    "videoUrl" : "http://media-server/media/video/XXX.webm", 
    "text" : "2-1-6", 
    "selfiePhotoUrl" : "http://media-server/media/selfie/XXX.jpeg", 
    "spriteUrl" : "http://media-server/media/selfie/YYY.jpeg"
  }, 
  "error" : {
    "type" : "StepError", 
    "code" : "voice.matchingFailed", 
    "message" : "Numbers from task and in video do not match"
  }
}

"step" : {
  "status" : 200, 
  "id" : "voice", 
  "data" : {
    "videoUrl" : "http://media-server/media/video/XXX.webm", 
    "text" : "6-8-0", 
    "selfiePhotoUrl" : "http://media-server/media/selfie/XXX.jpeg", 
    "spriteUrl" : "http://media-server/media/selfie/YYY.jpeg"
  }, 
  "error" : {
    "type" : "StepError", 
    "code" : "voice.faceMismatch", 
    "message" : "The face from movement and voice checks is not the same"
  }
}

"step" : {
  "status" : 200, 
  "id" : "voice", 
  "error" : {
    "type" : "StepError", 
    "code" : "node.failed", 
    "message" : "Cannot meet dependent node"
  }
}

Error Codes

"status" : 200, 
  "id" : "voice", 
  "data" : {
    "videoUrl" : "http://media-server/media/video/XXX.webm", 
    "text" : "1-8-1", 
    "selfiePhotoUrl" : "http://media-server/media/selfie/XXX.jpeg", 
    "spriteUrl" : "http://media-server/media/selfie/YYY.jpeg"
  }, 
  "error" : {
    "type" : "mediaserver.id.error", 
    "code" : "400", 
    "message" : "selfie_id download error"
}

"step" : {
  "status" : 200, 
  "id" : "voice", 
  "data" : {
    "videoUrl" : "http://media-server/media/video/XXX.qt", 
    "text" : "9-8-5", 
    "selfiePhotoUrl" : "http://media-server/media/selfie/XXX.jpeg", 
    "spriteUrl" : "http://media-server/media/selfie/YYY.jpeg"
  }, 
  "error" : {
    "type" : "REQUEST_REJECTED", 
    "code" : "503", 
    "message" : "Request is rejected when call 'visionAgent.facematch' action on 'mol-verification-XXX' node."
  }
}

"step" : {
  "status" : 200, 
  "id" : "voice", 
  "data" : {
    "videoUrl" : "https://media.getmati.com/file?location=XXX", 
    "text" : "0-4-6", 
    "selfiePhotoUrl" : "https://media.getmati.com/file?location=YYY", 
    "spriteUrl" : "https://media.getmati.com/file?location=ZZZ"
  }, 
  "error" : {
    "code" : "504", 
    "message" : "Request timeout"
  }
}

watchlists

Step Completed

"step": {
  "status": 200,
  "id": "watchlists",
  "error": null,
  "data": [
    {
      "watchlist": {
        "id": 470,
        "name": "INTERPOL Red Notices"
      },
      "searchParams": {
        "fullName": "John Doe",
        "dateOfBirth": "01-01-1990"
      },
      "dataSource" : "custom-fields",
      "searchResult": null,
      "searchedAt": "2022-08-24T14:45:00.569Z"
    },
    {
      "watchlist": {
        "id": 183,
        "name": "FBI Most Wanted"
      },
      "searchParams": {
        "fullName": "John Doe",
        "dateOfBirth": "01-01-1990"
      },
      "dataSource" : "custom-fields",
      "searchResult": null,
      "searchedAt": "2022-08-24T14:45:00.569Z"
    }
  ]
}

Step Error

"step" : {
  "status" : 200, 
  "id" : "watchlists", 
  "error" : {
    "type" : "StepError", 
    "code" : "watchlists.notEnoughParams", 
    "message" : "No data to extract information"
  }
}

"step" : {
  "status" : 200, 
  "id" : "watchlists", 
  "error" : {
    "type" : "StepError", 
    "code" : "input.failed", 
    "message" : "Cannot meet dependent input"
  }
}

"step": {
  "status": 200, 
  "id": "watchlists", 
  "error": {
    "type": "StepError", 
    "code": "node.failed", 
    "message": "Cannot meet dependent node"
  }
}

"step": {
  "status": 200,
  "id": "watchlists",
  "error": {
    "type": "StepError",
    "code": "watchlists.matchFound",
    "message": "We found a match inside a watchlist"
  },
  "data": [
    {
      "watchlist": {
        "id": 450,
        "name": "Swiss SECO Sanctions"
      },
      "searchParams": {
        "fullName": "John Doe",
        "dateOfBirth": "01-01-1990"
      },
      "documentType": "passport",
      "country": "MX",
      "dataSource" : "document-data",
      "searchResult": {
        "watchlistId": 450,
        "fullName": "John Doe",
        "dateOfBirth": "01-01-1990"
      },
      "searchedAt": "2022-05-24T14:45:00.414Z",
      "error": {
        "type": "StepError",
        "code": "watchlists.matchFound",
        "message": "We found a match inside a watchlist"
      }
    },
    {
      "watchlist": {
        "id": 450,
        "name": "Swiss SECO Sanctions"
      },
      "searchParams": {
        "fullName": "Jack Doe",
        "dateOfBirth": "01-01-1990"
      },
      "documentType": "national-id",
      "country": "MX",
      "dataSource" : "document-data",
      "searchResult": null,
      "searchedAt": "2022-05-24T14:45:00.569Z"
    }
  ]
}

"step": {
  "status": 200,
  "id": "watchlists",
  "error": {
    "type": "StepError",
    "code": "watchlists.skipped",
    "message": "No watchlists were enabled in flow"
  }
}

"step": {
  "status": 200,
  "id": "watchlists",
  "error": {
    "type": "StepError",
    "code": "watchlists.notEnoughParams",
    "message": "Not enough data to perform watchlists search"
  },
  "data": [
    {
      "watchlist": {
        "id": 258,
        "name": "UK Most Wanted"
      },
      "searchParams": null,
      "documentType": "passport",
      "country": "MX",
      "dataSource" : "document-data",
      "searchResult": null,
      "searchedAt": null,
      "error": {
        "type": "StepError",
        "code": "watchlists.notEnoughParams",
        "message": "Not enough data to perform watchlists search"
      }
    },
    {
      "watchlist": {
        "id": 258,
        "name": "UK Most Wanted"
      },
      "searchParams": {
        "fullName": "John Doe",
        "dateOfBirth": "01-01-1990"
      },
      "documentType": "national-id",
      "country": "MX",
      "dataSource" : "document-data",
      "searchResult": null,
      "searchedAt": "2022-07-12T14:55:18.014Z"
    }
  ]
}

{
  "status": 200,
  "id": "watchlists",
  "error": {
    "type": "StepError",
    "code": "watchlists.matchFound",
    "message": "We found a match inside a watchlist"
  },
  "data": [
    {
      "watchlist": {
        "id": 450,
        "name": "Test Watchlist 1"
      },
      "searchParams": {
        "fullName": "Some Name",
        "dateOfBirth": "03-11-1992"
      },
			"dataSource" : "custom-fields",
      "searchResult": {
        "watchlistId": 450,
        "fullName": "Some Name",
        "dateOfBirth": "03-11-1992"
      },
      "searchedAt": "2022-05-24T14:45:00.414Z",
      "error": {
        "type": "StepError",
        "code": "watchlists.matchFound",
        "message": "We found a match inside a watchlist"
      }
    },
    {
      "watchlist": {
        "id": 470,
        "name": "Test Watchlist 2"
      },
      "searchParams": {
        "fullName": "Some Name",
        "dateOfBirth": "03-11-1992"
      },
			"dataSource" : "custom-fields",
      "searchResult": null,
      "searchedAt": "2022-05-24T14:45:00.569Z"
    }
  ]
}

System Error

"step": {
  "status": 200, 
  "id": "watchlists", 
  "error": {
    "type": "SystemError", 
    "code": "system.internalError", 
    "message": "Step timeout"
  }
}

"step": {
  "status": 200, 
  "id": "watchlists", 
  "error": {
    "type": "SystemError", 
    "code": "system.internalError", 
    "message": "Internal error"
  }
}

Updated about 1 month ago