Field
Verification status of individual KYC fields in SEP-12.
Indicates the current state of each provided field during the KYC process. Allows anchors to communicate field-level verification status and requirements.
Status meanings:
ACCEPTED: Field has been verified and accepted
PROCESSING: Field is being reviewed
REJECTED: Field was rejected (see error property for reason)
VERIFICATION_REQUIRED: Field needs additional verification (e.g., email/phone code)
Use cases:
Email verification: Status is VERIFICATION_REQUIRED until code is submitted
Phone verification: Status is VERIFICATION_REQUIRED until SMS code is provided
Document review: Status is PROCESSING while being reviewed, then ACCEPTED or REJECTED
Field corrections: Status is REJECTED with error message indicating what's wrong
Example - Check field status:
val response = kycService.getCustomerInfo(request)
response.providedFields?.forEach { (fieldName, fieldInfo) ->
when (fieldInfo.status) {
FieldStatus.ACCEPTED -> {
println("$fieldName: Verified")
}
FieldStatus.PROCESSING -> {
println("$fieldName: Under review")
}
FieldStatus.REJECTED -> {
println("$fieldName: Rejected - ${fieldInfo.error}")
}
FieldStatus.VERIFICATION_REQUIRED -> {
println("$fieldName: Verification code required")
}
null -> {
println("$fieldName: Status not provided")
}
}
}Example - Handle email verification:
val emailField = response.providedFields?.get("email_address")
if (emailField?.status == FieldStatus.VERIFICATION_REQUIRED) {
// User receives email with code
val verifyRequest = PutCustomerInfoRequest(
jwt = authToken,
verificationFields = mapOf(
"email_address_verification" to "123456"
)
)
kycService.putCustomerInfo(verifyRequest)
}See also:
GetCustomerInfoProvidedField for field information with status
CustomerStatus for overall customer verification status
Entries
Properties
Functions
Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
Returns an array containing the constants of this enum type, in the order they're declared.