CreateQuoteUserDetailCommand

Overview

Creates a user profile for an anonymous (walk-in) loan applicant who does not have a self-service account. Validates the applicant's biometric identity against core banking, then creates a pre-registration record and initiates OTP email verification.

Command Structure

{
  "cmd": "CreateQuoteUserDetailCommand",
  "data": "{\"firstName\":\"Adaeze\",\"lastName\":\"Okafor\",\"mobileNumber\":\"08012345678\",\"emailAddress\":\"adaeze@example.com\",\"dateOfBirth\":\"1990-05-15\",\"gender\":\"Female\",\"mobileCountryCode\":\"+234\",\"biometricsId\":\"BIO123456\"}"
}

Parameters

Parameter	Type	Required	Description
firstName	string	Yes	Applicant's first name
lastName	string	Yes	Applicant's last name
mobileNumber	string	Yes	Phone number
emailAddress	string	Yes	Email address
dateOfBirth	string (date)	Yes	Date of birth (ISO 8601)
gender	string	Yes	Gender
mobileCountryCode	string	Yes	Country dial code (e.g. +234)
middleName	string	No	Middle name
biometricsId	string	Yes	Biometric reference ID from core banking

Validations

• Email address must not already belong to an existing self-service user (blocks duplicate registrations)
• biometricsId is validated against core banking — returns an error if not found

Process

1. Checks that no existing user has the same email
2. Validates biometric ID in core banking
3. Creates a QuoteUserDetail record
4. Creates a SelfServiceUserPreRegistration record
5. Sends OTP verification email

Response

{
  "ok": true,
  "statusCode": "00",
  "message": "Quote user profile created successfully.",
  "outData": {
    "QuoteUserDetailId": 45,
    "DisplayName": "Adaeze Okafor",
    "RequestId": "2026062891234",
    "UserId": 301,
    "EmailAddress": "adaeze@example.com",
    "VerificationType": "REGISTRATION"
  }
}

Related Commands

• CreateSelfServiceLoanRequestCommand
• GetAllMyLoanApplicationsQuery