Challenge failed

Summary

Fires when a KYC challenge runs out of attempts. Code-based challenges do not send this event: a lapsed code is not a decision, and the user can request a new one.

Payload

The challenge.failed event sends the account it relates to and a summary of the challenge. kyc.reasons carries why the last submission was rejected, for example liveness_failed, face_mismatch, document_no_face or document_expired.

{
  event: "challenge.failed",
  account: String,
  challenge: {
    id: String,
    status: "failed",
    type: "kyc",
    reasons: String[],
    kyc: { level: String, reasons: String[] },
    createdAt: Date,
    updatedAt: Date,
  }
}