Skip to main content

Password MFA Verification


Use Password MFA Verification to verify a 6-digit MFA code before password change.



This screen includes:

#ElementDescription
1Verification code modalRequests the 6-digit authentication code.
2Close actionCloses the modal.
3Modal titleDisplays Verification code.
4Instruction textDirects the user to the authenticator app.
5Code input fieldsAccept the 6-digit verification code.
6Verify actionSubmits the verification code.
7Background stateShows the change password screen behind the modal.

Workflow​

  1. Start password change.
  2. Display the MFA verification modal when MFA is required.
  3. Enter the 6-digit authentication code.
  4. Select Verify.
  5. Complete password change after successful verification.

Validations​

ScenarioApp behaviorSDK output
Session invalidBlock requeststate = unauthenticated
MFA code missingDisable Verifyvalidation = mfa_code_required
MFA code incompleteDisable Verifyvalidation = mfa_code_incomplete
MFA code invalidDisplay verification errorerror = invalid_mfa_code
MFA code expiredDisplay expiration errorerror = mfa_code_expired
MFA verification succeedsComplete password changestate = verified
Request rejectedDisplay error statestatus = 405

Actions​

ScenarioApp behaviorSDK output
MFA requiredLoad verification modalPUT /api/v3/account/password/mfa
MFA code enteredUpdate code statemfaCode = updated
Verify selectedSubmit MFA verificationPOST /api/v3/account/password/change/mfa
Verification succeedsChange passwordstate = password_changed
Close selectedDismiss modalstate = dismissed
Request rejectedPreserve current statestate = unchanged

Endpoint Resources​

Password MFA Verification​

PUT 

v3/account/password/mfa

Returns the MFA verification modal.

Accept Change Password with MFA​

POST 

v3/account/password/change/mfa

Changes the password after MFA verification.