Docs
Developer Hub

Step Completed: A

Suggest Edits

age-check

Step Completed

"step" : {
	"status" : 200, 
	"id" : "age-check", 
	"data" : {
		"age" : 28, 
		"ageThreshold" : 18, "underage" : false
	}, 
	"error" : null
}

Step Error

"step" : {
  "status" : 200, 
  "id" : "age-check", 
  "data" : {
    "age" : null, 
    "ageThreshold" : 18, 
    "underage" : null
  }, 
  "error" : {
    "type" : "StepError", 
    "code" : "underage.noDOB", 
    "message" : "The date of birth could not be obtained"
  }
}

"step" : {
    "status" : 200, 
    "id" : "age-check", 
    "data" : {
        "age" : 0, 
        "ageThreshold" : 18, 
        "underage" : true
    }, 
    "error" : {
        "type" : "StepError", 
        "code" : "underage.error", 
        "message" : "This user is currently underage"
    }
}

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

alteration-detection

Step Completed

"step" : {
	"status" : 200, 
	"id" : "alteration-detection", 
	"error" : null
}

Step Error

"step" : {
	"status" : 200, 
	"id" : "alteration-detection", 
	"error" : {
		"type" : "StepError", 
		"code" : "alterationDetection.negligence", 
		"message" : "Document is considered as negligence",
    "reasonCode" : "blurred"
	},
  "documentType" : "passport"
}

"step" : {
	"status" : 200, 
	"id" : "alteration-detection", 
	"error" : {	
		"type" : "StepError", 
		"code" : "alterationDetection.fraudAttempt", 
		"message" : "Document is considered as fraud attempt",
    "reasonCode" : "screenshot"
	},
  "documentType" : "national-id"
}

"step" : {
	"status" : 200, 
	"id" : "alteration-detection", 
	"error" : {
		"type" : "StepError", 
		"code" : "alterationDetection.tampered", 
		"message" : "Document is considered tampered"
	}
}

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

📘

Possible reasonCode Values for Fraud and Negligence Errors

Both alterationDetection.fraudAttempt and alterationDetection.negligence have a reasonCode as part of the webhook response. The codes can be one of the following values:

reasonCodeDashboard Statement
digitalPhotoReplacementThe photo on the document has been digitally altered
fakeThe image is synthetic. The information on it is unreal.
textReplacementThe text on the document has been replaced with different information
manualPhotoReplacementThe photo on the document has been altered
differentFrontAndBackThe document front information or type does not match the back information or type
underageThe person on the document is underage
physicalObstructionThere is a physical obstruction that prevents to see the entire document
digitalObstructionThere is a digital obstruction that prevents to see the entire document
blurredThe image is blurred that hides information on the document
pixelatedThe image is pixelated that hides information on the document
screenPhotoThe image is a picture of a screen where the document is stored
grayscaleThe image is a black and white copy of the document
croppedThe document is cropped
distortedThe image is distorted making the quality of the image poor
sameImagesThe same image (front or back) was uploaded twice
colorCopyThe image is a color copy of the document
screenshotThe image is a screenshot
incorrectDocumentThe document uploaded is incorrect
noDocumentThere's no document on the picture

System Error

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

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

Updated 13 days ago