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