How to Connect a Cloud Based Application to Verified First

Integrating the Verified First platform into your cloud-based solution is faster and easier than any other vendor in the industry.  

Ordering Method 1: Embedded JavaScript Widget

Embedding a line of JavaScript code is a simple task for your development team. Embedding this code allows your users to seamlessly utilize the system with zero effort on their side, and minimal development on your side.

NOTE: Before you can test the JavaScript code, Verified First must whitelist the URL(s) it will be loaded from.

STAGING CODE
<!-- Verified First --> 
<script type="text/javascript"src="https://widget1.verifiedfirst.com/Browser-Extension/src/app/widget.js" async></script>
<!-- End Verified First -->

PRODUCTION CODE 
<!-- Verified First --> 
<script type="text/javascript"src="https://widget.verifiedfirst.com/Browser-Extension/src/app/widget.js" async></script>
<!-- End Verified First -->

Ordering Method 2: Browser Extension (patented)

Verified First has an official browser extension with Chrome, Firefox, Edge, and Safari. This requires zero development on your side, and minimal effort for your end-users. The install process is two clicks and takes less than a minute in most cases. Simply direct them to our browser install page. 

Note: There is no browser add-on available for Internet Explorer. Because of this we recommend using the "Embed JavaScript Code" option. 

Configuring Button and Menu Icon (Optional)

Verified First will work with the Partner to select the placement of the Verified First injected button.

- The partner can add the following DIV tag to the page to control if, when, and where the Verified First button shows.

<div id="vf-widget-button-wrap"></div>

- The partner can add the following DIV tag to the page to control if, when, and where the "Menu" icon shows

<div id="vf-widget-menu-wrap"></div>

- The partner can add the following elements the partners UI to control the opening of the Verified First widget to a specific page.

class=“vf-open-report” id=“{order_id}” -> open report page
class=“vf-open-full-report” id=“{order_id}” -> open report page with report
class=“vf-place-order” -> open order page and pre-fill
class=“vf-open-settings” -> open settings page
class=“vf-open-users-settings” -> open users settings page
class=“vf-open-packages-settings” -> open packages settings page
class=“vf-open-menu” -> open index page with sidebar
class=“vf-open-dashboard” -> open index page with dashboard

Advanced Regex Mapping (Recommended)

We map to specific values in your HTML to pre-fill our ordering Widget. We recommend placing specific hidden tags with the values used to pre-fill orders and lead capture forms. This ensures that if the HTML of your page changes our Regex mapping is not broken. 

<div id="verified-first"> 
  <div class="hidden"> 
    <input type="hidden" id="partner-applicant-id" value="eb94d16f-12ce-406d-99ab-a84d00af4eea"> 
    <input type="hidden" id="individual-first-name" value="John"> 
    <input type="hidden" id="individual-last-name" value="Applicant"> 
    <input type="hidden" id="individual-middle-name" value="A"> 
    <input type="hidden" id="individual-suffix" value="Jr."> 
    <input type="hidden" id="individual-email" value="JohnApplicant@gmail.com"> 
    <input type="hidden" id="individual-date-of-birth" value="01/01/1975"> 
    <input type="hidden" id="individual-ssan" value="111-11-1111"> 
    <input type="hidden" id="individual-mobile-phone" value="253-555-1212"> 
    <input type="hidden" id="individual-address-line-1" value="1550 S Tech Lane Suite 200"> 
    <input type="hidden" id="individual-address-line-2"> 
    <input type="hidden" id="individual-address-city" value="Meridian"> 
    <input type="hidden" id="individual-address-state" value="Idaho"> 
    <input type="hidden" id="individual-address-postal-code" value="83642"> 
    <input type="hidden" id="individual-address-postal-country" value="US"> 
    <input type="hidden" id="user-firstname" value="George"> 
    <input type="hidden" id="user-lastname" value="Washington"> 
    <input type="hidden" id="user-email" value="George@FirstPresident.com"> 
    <input type="hidden" id="user-phone" value="818-555-1212"> 
    <input type="hidden" id="user-company" value="United States of America"> 
    <input type="hidden" id="user-misc1" value="Optional Data"> 
    <input type="hidden" id="user-misc2" value="Optional Data"> 
    <input type="hidden" id="user-misc3" value="Optional Data"> 
  </div> 
</div>

Receiving Results via the Verified First API (Recommended)

Without receiving the results via the API, results come back to the widget so that your HR team can review them within your platform. 

If you would like to receive a copy of this data to store in your platform, for reporting or gating the hiring process for example, we need:

1. Endpoint  
2. Authorization header or credentials to authenticate the message

{
 "type": "background status",
 "status_update": {
 "partner_applicant_ids": ["eb94d16f-12ce-406d-99ab-a84d00af4eea"],
 "account_number": "111-2222-33333-444444",
 "order_id": "b06a10e0-ef0b-11e8-8c06-017b64ae2d2844",
 "order_number": "2240992",
 "flagged": "No",
 "package_name": "Verified Basic",
 "products_ordered": [
 "Social Security Address Trace",
 "Nationwide Criminal Database",
 "Adjudication"
 ],
 "reference_code": "Salaries",
 "status": "Complete",
 "state": "Active",
 "adjudication": "In Need of Review",
 "url": "https://staging.verifiedfirst.com/#/report-results/b06a10e0-ef0b-11e8-8c06-017b64ae2d2844",
 "order_completed_date": "2018-12-05T18:58:31Z",
 "last_status_date": "2018-12-05T18:58:31Z"
 }
}

Field Definitions:

• partner_applicant_ids - Unique identifier of applicant from external system (received from value(s) defined in "Create Order" API call)
• account_number - Account number assigned by Verified First
• order_id - Internal Verified First order identifier
• order_number - Order number created by Verified First
• flagged - Indicates if the order is flagged (Yes/No)
• package_name - Package name used for the order
• products_ordered - The list of products contained in the selected package for the order
• reference_code - Reference code associated with the order (optional)
• status - The latest status of the order
  • Canceled - Order has been canceled by the vendor
  • Error - An error was generated when an order for a report was placed
  • Waiting on Applicant - Order has been created by the vendor
  • Invitation Sent - Invitation has been sent to applicant
  • Partially Ordered - Verified First Portal user has performed Pre-Pull tasks and has developed jurisdictions for the applicant, but has not completed the order
  • Ready to Order - Applicant has finished the invitation and the order is ready for review.  Requires Account settings (Gear > Admin > Account > Review Process) to be set to either "Allow Both" or "Manual Order Only"
  • File Ordered - Background check file has been ordered
  • Partially Complete - At least one selected product has been completed for the file
  • Complete - The file has been completed and returned
• state - The activation state of the order.  Orders that are archived (either manually or by scheduled expiration) move from "Active" state to "Inactive" state. (Active/Inactive)
• adjudication - Adjudication status of the order (this field will only have values populated if "status" is "Complete")
  • In Need of Review
  • Approved
  • Pre-Adverse Action
  • Adverse Action
• url - Link to view order
• order_completed_date - Date that the order was completed (will be filled when "status" is "Complete")
• last_status_date - Date of the most up-to-date status

Co-Branding (Recommended)

Our solution can also be co-branded with your colors and logo to provide end-users with a familiar and trusted experience. Logo requirements are listed below:

1. 600x120
2. Transparent background
3. PNG format
4. Size should be less than 100 Kb

If you have any further questions, or need a product enabled on your account, 
please contact Verified First Client Services for assistance.

Call 844-709-2708 or email ClientServices@VerifiedFirst.com