Performing a VEVO Visa Check

What is a VEVO Visa Check?

A Visa Entitlement Verification Online (VEVO) check allows you to confirm the visa status and conditions of a non-Australian citizen, directly against the Department of Home Affairs records. It is a critical tool for ensuring a potential employee has the right to work or that a customer meets residency requirements.

FrankieOne integrates this check as a VISA step within our workflow engine, allowing you to automate this process as part of your standard onboarding or due diligence.

VEVO vs. DVS Passport Check

It’s important to understand the distinction between a VEVO check and a DVS Passport check, as they serve different purposes.

• Use the Document Verification Service (DVS) to verify the identity details on a visa record. It confirms that the document number, name, and date of birth match the record held by the Department of Home Affairs.
• Use the Visa Entitlement Verification Online (VEVO) check to verify the current visa status and conditions (e.g., work rights, study limitations) linked to a foreign passport.

For identity verification, the DVS check is often sufficient. However, if you need to confirm the specific entitlements and conditions of the visa itself, a VEVO check is required.

How It Works

The process is managed through two main API interactions integrated into a workflow.

Implementation Guide

Step 1: Provide the Foreign Passport Data

The VEVO check is performed using the details of a foreign passport. You must include these details in the documents array when you create or update an individual.

• type: Must be PASSPORT.
• primaryIdentifier: The passport number.
• country: The passport’s country of issue (e.g., GBR for Great Britain).

1
{
2
    "individual": {
3
        "name": { "givenName": "John", "familyName": "Smith" },
4
        "dateOfBirth": { "year": "1990", "month": "05", "day": "15" },
5
        "documents": [
6
            {
7
                "class": "IDENTITY",
8
                "type": "PASSPORT",
9
                "primaryIdentifier": "E07148293",
10
                "country": "GBR" 
11
            }
12
        ],
13
        "consents": [ { "type": "DOCS" } ]
14
    }
15
}

Step 2: Execute the Workflow

With the entity created, execute the workflow containing the VISA step.

$
POST /v2/individuals/{entityId}/serviceprofiles/{serviceName}/workflows/{workflowName}/execute

Interpreting the Visa Check Result

The outcome of the check is found within the workflowStepResults array, inside the object where stepName is VISA.

The VISA Step Summary

The summary object gives you a high-level overview and is useful for quick decisioning based on your configured allow/deny lists.

1
"summary": {
2
    "stepName": "VISA",
3
    "country": "AUS",
4
    "class": "Student",
5
    "subClass": "500",
6
    "hasExpired": false,
7
    "onAllowList": true,
8
    "onDenyList": false
9
}

• onAllowList / onDenyList: These booleans tell you if the visa’s class/subclass matched the lists you configured in the workflow step. This is often all you need for automated decisioning.

The Process Result (supplementaryData)

For the most detailed information, you must inspect the supplementaryData object within the step’s processResults. This contains the full entitlement details returned from VEVO.

Workflow Configuration

The VISA step in your workflow can be customized with allow or deny lists based on visa classes and subclasses. This allows you to tailor the check to your specific business needs (e.g., only accepting work visas).

1
"visaCheck": {
2
    "allowedVisaType": {
3
        "AU": {
4
            "classes": [
5
                { "class": "*", "subclass": "482" },
6
                { "class": "*", "subclass": "189" }
7
            ]
8
        }
9
    }
10
}

Supported Visa Categories

Below is a summary of the key visa groups we support:

Unsupported Visa Types

The following visa types are not currently on our allow list and will result in a failed verification: