/

to search

Introducing Setu Changelog Check it out ↗

#Error codes and messages for Aadhaar eSign APIs

Below is a table which contains the error codes and corresponding error messages, for errors that may occur during the eSign flow.

Error code Error message
session_expired The session has expired. Please try again.
document_already_signed The document has already been signed successfully.
document_not_found This document is not available anymore.
signature_creation_failure Failed to generate signature.
exceeded_otp_retries Exceeded OTP failure attempts.
otp_not_entered User terminated eKYC process after OTP Generation.
signer_declined Document signing was declined.
otp_expired OTP expired.
aadhaar_not_linked Aadhaar not linked with mobile.
service_down ESP service down.
name_match_errorYour name does not match with the data received from Aadhaar.
yob_match_errorYour year of birth does not match with the data received from Aadhaar.
invaild_otpInvalid OTP value.
aadhaar_not_linkedAadhaar number does not have mobile number.
otp_flooding_errorOTP Flooding error.
transaction_not_allowedtransaction not allowed
exceeded_otp_generationExceeded Maximum OTP generation Limit. Please try After some time.
exceeded_otp_attemptMaximum number of attempts for OTP match is exceeded or OTP is not generated. Please generate a fresh OTP and try to authenticate again.
wait_otp_generation_1minPlease wait for a minute to generate a new OTP.
wait_otp_generation_30minThe maximum OTP generation limit (5) has been exceeded. Please wait for 30 minutes to generate a new OTP.
tnx_value_mismatchtxn value did not match with txn value of Request OTP API.
wait_otp_generation_1minPlease wait for a minute to generate a new OTP.
aadhaar_lockedAadhaar locked by Aadhaar number holder. This mean that all permanent forms of identifiers are locked for any kind of authentication. Resident can still use VID.
invalid_aadhaar_numberInvalid Aadhaar Number/Virtual ID.
exceeded_otp_attemptThe maximum allowed OTP attempts (3) has been exceeded. Please generate a fresh OTP and try to authenticate again
aadhaar_suspendedAadhaar suspended (Aadhaar is not in authenticatable status).
upstream_server_errorUpstream's internal service error

Was this page helpful?