home

MinistryPlatform

RealmRealm AccountingMinistryPlatformPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite
RealmRealm AccountingMinistryPlatformPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite

What would you like to know more about?

Show Contents

Show Page Sections

thumbnailMinistryPlatform

Integrations

Verified First

The Verified First integration works with the Platform to facilitate and automate everything you need for Background Checks.

Overview

With this integration, you can connect the Platform with the Verified First background screening solution. After it's set up, you can request a background check using the Background Check Request Tool in MinistryPlatform. That request is sent to Verified First using the credentials set up in your configuration settings.

Once Verified First has the results for your background check request and you have approved it in the Verified First client portal, the records are updated in the Platform. Finally, the nightly routine updates the relevant dates for you, including Background Check Submitted, Background Check Returned, and Background Check Expires.

Managing Background Checks

To manage Background Checks, see Background Checks.
Important: You must process background checks for Drug Screening and I-9 Employment Eligibility via the Verified First client portal. You cannot use the Background Check Tool for these requests because they require written justification.

Cost

There is no charge from ACS Technologies for configuring the integration.

Fees from Verified First will be assessed as per each church's individual contract agreement.

Watch & Learn

See Also

Step 1: Create an Account with Custom Packages

  • Before you can set up your integration, you'll need to have an account with Verified First.
Contact Verified First to set up an account and create the packages you would like to have. You can customize these packages and have as many as you need.

Step 2: Initiate Setup in MinistryPlatform

Submit a case via the Support Portal, letting the Support team know you want to use Verified First for all your background check needs. Provide the Package Name (Background Check Type) and Package GUID (Package Service Code, which can be pulled from the package URL) for every package you have with Verified First.

Or, you can complete the Platform setup yourself.

  1. Go to Lookup Values > Background Check Types.
  2. Click New.
  3. Enter the necessary information:
    1. Background Check Type: The Verified First package name.
    2. Package Service Code: The package GUID in the package URL.
  4. Optional: Optionally, include:
    1. Months Till Expires
    2. Expiring Soon Days
    3. Type Needs Review
  5. Click Save.
  6. Repeat these steps for each separate package you want to add.

Step 2a: Adjudication (Optional)

All Verified First packages include adjudication except SSTrace + MVR. When MinistryPlatform receives a post back from Verified First with a status of Complete and an adjudication value of Ready for Review, the status will be updated in the Platform, but the All Clear field will still be undefined.

After a church staff member reviews and approves the report in the Verified First portal, Verified First sends another post back to MinistryPlatform with an adjudication value of Approved. At that point, the All Clear field will be updated to Yes.

Step 2b: Prepare MinistryPlatform

  1. Go to Administration > Configuration Settings.
  2. Update your Verified First credentials.
    1. COMMON, BackgroundCheckProvider: This should be "Verified First".
    2. COMMON, BackgroundCheckUsername: The username provided by Verified First.
    3. COMMON, BackgroundCheckPassword: The password provided by Verified First.
    4. COMMON, BackgroundCheckOrderUrl: The endpoint URL provided by Verified First. This is where MinistryPlatform will send background check requests.
    5. TOOLS, BackgroundCheckCallbackUsername: The username that Verified First will use to authenticate with MinistryPlatform for postback requests. You create this and supply it to Verified First.
    6. TOOLS, BackgroundCheckCallbackPassword: The password that Verified First will use to authenticate with MinistryPlatform for postback requests. You create this and supply it to Verified First.

Step 3: Submit a Test

  1. Using the Add/Edit Family Tool, create two Contact records in MinistryPlatform.
    1. This will return a sample report with records:
      • First Name: Hank
      • Last Name: Mess
      • Email Address: Enter your own so you receive the background check request.
    2. This will return a sample report with no records:
      • First Name: Joe
      • Last Name: Clean
      • Email Address: Enter your own so you receive the background check request.
  2. Create a test submission to ensure the integration is working as currently configured.
  3. Select your test contacts, Hank Mess and Joe Clean.
  4. Launch the Background Check Request tool from a selection or record. Or launch the tool and search for your test records inside the tool.
  5. Set the Background Check type.
  6. Optional: Select the Ministry.
  7. Optional: Add notes to the Notes field.
  8. Click Submit to create the background checks and submit them to Verified First.
  9. You'll receive an acknowledgment that you've submitted it successfully.
  10. Confirm a record has been created on the Background Checks page.
  11. After you receive the email requests, click the link and enter each Contact's fictional information.
    Tip: The fictional information can be obtained from the Verified First testing documentation.
  12. Follow the link provided on the Background Check record to review and optionally approve the report.
  13. Confirm the results have populated on the Background Checks page.
If you need assistance with any of these steps, contact Support.
Integration
Webinar
MinistryPlatform
portal

Last updated: May 9, 2024