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.