Step 3: Get Detailed Results

Once the MFA transaction has completed, additional details can be retrieved. See below for information returned:

Request

The transactionRecordId will be available at the callbackURL provided in the Verify request.

GET /verifications/v1/transactionrecord/<transactionRecordId> HTTP/1.1
Host: <<endpoint>>
Content-Type: application/json
Authorization: Basic ACCESS_TOKEN

Response

If the CellNumber is a match the customer has correctly entered the one-time passcode

"TransactionID": "da57e8c3-e405-4a21-b492-6076b10f99bd",
    "UploadedDt": "2021-07-07T23:31:41",
    "CountryCode": "CA",
    "ProductName": "Identity Verification",
    "Record": {
        "TransactionRecordID": "20ccdf85-5d3b-4859-8d1e-0594fc7473aa",
        "RecordStatus": "match",
        "DatasourceResults": [
            {
                "DatasourceStatus": "",
                "DatasourceName": "Mobile One-Time Passcode",
                "DatasourceFields": [
                    {
                        "FieldName": "MobileNumber",
                        "Status": "match"
                    }
                ],
                "AppendedFields": [
                    {
                        "FieldName": "NumberOfAttempts",
                        "Data": "1"
                    },
                    {
                        "FieldName": "MobileNetworkCode",
                        "Data": "610"
                    },
                    {
                        "FieldName": "MobileCountryCode",
                        "Data": "302"
                    },
                    {
                        "FieldName": "PhonePortedStatus",
                        "Data": "False"
                    },
                    {
                        "FieldName": "Operator",
                        "Data": "Bell Mobility (supported)"
                    },
                    {
                        "FieldName": "PhoneType",
                        "Data": "MOBILE"
                    },
                    {
                        "FieldName": "TimeoutReached",
                        "Data": "False"
                    },
                    {
                        "FieldName": "FraudFlag",
                        "Data": "False"
                    },
                    {
                        "FieldName": "OneTimePasscode",
                        "Data": "239716"
                    },
                    {
                        "FieldName": "CellNumber",
                        "Data": "16043459902"
                    }
                ],
                "Errors": [],
                "FieldGroups": []
            }
        ],
        "Errors": [],
        "Rule": {
            "RuleName": "RuleScript - OTP_v1",
            "Note": "1 Records Match\r\n(\r\nCellNumber\r\n)"
        }
    },
    "Errors": []
}

Field Name

Definition

Operator

The mobile network operator used by the phone number provided.

PhoneType

The type of phone used - Mobile, Landline, VoIP, etc.

PhonePortedStatus

Boolean indicating whether the Phone has been ported to a new mobile network operator

MobileNetworkCode
MobileCountryCode

The MobileNetworkCode and MobileCountryCode are used to uniquely identify a mobile network operator.

OneTimePasscode

The one-time passcode that is sent to end-user.

NumberOfAttempts

The number of attempts by end-user to input one-time passcode.

TimeoutReached

Boolean indicating if passcode has expired.

FraudFlag

Boolean indicating fraudulent activity. For MFA, FraudFlag = ‘True’ if

  1. The passcode expired
  2. The phone type is voice over IP (VoIP)
  3. If the number of incorrect attempts to enter passcode is high

FraudMessage

Additional details on why the transaction was deemed fraudulent. Examples of FraudMessage value:

  1. The one-time passcode has expired
  2. Risky phone type detected - VoIP
  3. High number of failed attempts

What’s Next
Did this page help you?