KYCKey Features

Performing a Visa Check

Leverage FrankieOne to efficiently perform Visa Checks. This guide explains how to configure and execute a Visa Check as part of your KYC workflow.

Introduction to VEVO Visa Checks

FrankieOne simplifies the process of verifying visa status through the visaCheck step in your workflow. This feature enables you to confirm whether a user holds a valid visa and is authorized to work in Australia, helping you maintain compliance with local regulations.

You can customize the visaCheck step to target specific visa categories, such as student or work visas. This flexibility ensures your verification process is aligned with your business requirements and only checks for relevant visa types.

In Australia, the Visa data source is the Visa Entitlements Verification Office (VEVO). The first supported country for Visa Checks is Australia, and this service is referred to as the “VEVO Visa Check”.

What’s the difference between VEVO vs the DVS Passport Visa check?

The key difference between VEVO and the DVS is that the DVS verifies identity information associated with a visa record while VEVO doesn’t.

  • Use Visa Entitlement Verification Online (VEVO) to verify the current visa details and conditions linked to a passport.
  • Use the Document Verification Service (DVS) to verify that a visa is in effect and that the document number, name, and date of birth match the current Department of Home Affairs identity record.

For identity verification checks, the DVS passport service, in general, will suffice. However, if you require details of the visa and its conditions then both the DVS and VEVO checks can be configured.

Prerequisites

Before you can perform a Visa Check, ensure you have the following:

  • A FrankieOne account with access to the Visa Check feature added to your account’s configured workflows.
  • A valid Australian passport or other acceptable identification documents for the user whose visa status you want to check.
  • The user’s consent to perform the Visa Check.

Reach out to your FrankieOne account manager to enable the Visa Check feature if it is not already available in your account.

The Visa Check feature is currently limited to Australian citizens and residents due to the scope of the current implementation. For users requiring visa checks for other countries, please contact our support team to explore alternative solutions or discuss potential feature enhancements.

How to Perform a Visa Check

The Visa Check process is straightforward and can be completed in a few simple steps. Below is a step-by-step guide to help you set up and execute a Visa Check using FrankieOne.

For workflows where you require identity verification results, ensure that a DVS Visa check is performed prior to the VEVO check.

The key difference between VEVO and the DVS is that the DVS verifies identity information associated with a visa record, while VEVO does not.

  • Use Visa Entitlement Verification Online (VEVO): To verify the current visa details and conditions linked to a passport.
  • Use the Document Verification Service (DVS): To verify that a visa is in effect and that the document number, name, and date of birth match the current Department of Home Affairs identity record.

For most identity verification checks, the DVS passport service will suffice. However, if you require details of the visa and its conditions, both the DVS and VEVO checks can be configured in your workflow.

1

Configure the Visa Check Step

To perform a Visa Check, you need to add the visaCheck step to any existing workflow or created as a new workflow.

The visaCheck step can be customized with a configured list of Visa Classes & Subclasses which you can either ALLOW or DENY. The following list options are available:

Example configuration:

1"DEFAULT": {
2            "classes": [
3                {
4                    "class": "*",
5                    "subclass": "400"
6                },
7                {
8                    "class": "*",
9                    "subclass": "500"
10                }
11            ]
12        }

Note: The "DEFAULT" key in the configuration is an example and can be replaced with any country code that aligns with your workflow setup. For instance, you can use "AU" for Australia. This ensures that the key country code is unique to the classes and subclasses per country in your implementation, allowing for country-specific visa configurations.

allowedVisaType

  • This option allows you to specify the visa types that are acceptable for your workflow. You can add a list of visa classes and subclasses, ensuring that only relevant visa types are allowed to pass the check.

deniedVisaType

  • This option allows you to specify the visa types that are not acceptable for your workflow. If a user holds a visa type from this list, the Visa Check will fail.

You can choose to use either allowedVisaType or deniedVisaType depending on your specific requirements. Visa Classes and Subclasses can be found in the Department of Home Affairs website.

Consult with your FrankieOne account manager for assistance in configuring the visaCheck step in your workflow.

The results of the Visa Check will be returned in the workflow response, indicating whether the user holds a valid visa and is authorized to work in Australia with either a MATCHED or NO_MATCH result.

2

Execute the Workflow with Visa Check

Once the visaCheck step is configured, you can execute the workflow using the API Endpoint below. The Visa Check will automatically verify the user’s visa status based on the provided identification document (Passport) and the configured visa types.

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

The results of the Visa Check will be returned in the workflow response, indicating whether the user holds a valid visa and is authorized to work in Australia with either a MATCHED or NO_MATCH resut.

3

Review the Check Results

After executing the workflow, review the results of the Visa Check with the API Endpoint below.

$GET /v2/individuals/{entityId}/serviceprofiles/{serviceName}/workflows/{workflowName}/executions/{workflowExecutionId}

The response will include details about the user’s visa status, including:

  • Visa Status: Indicates whether the visa is valid or not.
  • Visa Class: The class of visa held by the user.
  • Visa Subclass: The subclass of visa held by the user (if applicable).
  • Expiry Date: The date when the visa expires.
  • EntitlementStatus: Indicates the user’s entitlement to work in Australia.
  • Entitlement Code & Description: Provides additional information about the user’s work rights.

Check the supplementary data for any additional information that may be relevant to your business needs. For example, supplementary data might include details about the user’s visa conditions or any restrictions on work rights. This information can help you assess the user’s eligibility for specific roles or services more comprehensively.

Use this information to make informed decisions regarding the user’s eligibility for your services or products.

Using FrankieOne for Visa Checks is an efficient way to verify users’ visa status. By following this guide, you can ensure compliance with local regulations and make informed decisions about user eligibility. If you have any questions or need assistance with the Visa Check feature, please reach out to your FrankieOne account manager or our support team for help.