MFAChallenge – Developer Support

About MFA Challenge

Multi-Factor Authentication is required in order to submit a call to one of 4 MFA Protected Endpoints. Use this call to issue a challenge to the user’s registered mobile phone to authenticate. If no mobile phone is registered for the user, a BDC_1354 error will be returned. MFA Setup can currently only be completed through our web application.

Note: ChallengeId, as this will be required as part of MFAAuthenticate

Example

Request

<API_URL_EndPoint>/MFAChallenge.json

data={
   "useBackup" : false
}

Response

data={
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "challengeId" : "!a20Ob49EtAYKMvZ1SQjggzdVQ0xXhMa6SgBSIGdtRTpw"
  }
}

Resources

MFA Workflow

Parameters

Request parameters

Field Name	Description	Required?
useBackup	false = use primary registered mobile phone number, true = use backup registered mobile phone number	Yes