Guesty
      Back to home
      1. Knowledge Base
      2. Integrations
      3. Guesty

      How to connect Guesty with Authenticate®?

      Streamline Your Guest Verification Process with Authenticate's Integration for Guesty

      This guide provides a step-by-step process for integrating Authenticate with Guesty, a property management platform. This integration enables property hosts to perform robust identity verifications and criminal background checks on guests.

      Prerequisites

      Pass Criteria

      The pass criteria refer to the standards used to determine the success or failure of various checks performed during the ID verification process. 

      Below are the detailed criteria used for ID Verification, Criminal Check, Knowledge-Based Authentication (KBA), and Financial Account Ownership.

      1. ID Verification Status: The ID verification status determines the validity and verification level of a guest's ID. The criteria include:
      • valid_and_not_verified: The ID is valid, but it has not been verified through authoritative databases.
      • valid_and_not_us_id: The ID is valid and from a non-US country, with no additional checks supported for these IDs.
      • valid_and_live_match_fail: The ID is valid, but the selfie provided by the guest does not match the photo on the ID.
      • valid_and_verified: The ID is valid and has been verified through authoritative databases.
      2. 7-Year Criminal Report Status: The 7-year criminal report status indicates the results of the criminal background check:
      • clear: No criminal history was found in the report.
      • requires_review: The report found some results and further review by the host is recommended.
      • insufficient_data: The check could not be completed due to insufficient data.
      3. KBA Status: The Knowledge-Based Authentication (KBA) status reflects the outcome of the KBA process used to validate a guest's identity:
      • kba_verified: The KBA process successfully validated the guest's identity.
      4. Financial Account Ownership: The financial account ownership status verifies whether the guest owns the financial account as claimed:
      • fao_verified: The verification was successful, confirming the guest's account ownership.

      Note: We recommend that the pass criteria always align with the workflow. Failure to do so might lead to a less secure fraud prevention process and occasional workflow disruptions.

      Integration Process

      1. Install the Authenticate App

        • Navigate to the Guesty marketplace, log on to the portal, or install the Authenticate app here.
        • Click the"Connect" button.
          Guesty 1
        • You will receive an API Key from Guesty, necessary to enable integration in the Authenticate portal.
          Guesty 2

      2. Configure the Integration

        • Visit the Authenticate portal and proceed to the Guesty integration page.
        • Input the Integration Token received from Guesty into the designated field and activate the integration.
          Guesty 3

      3. Brand and Workflow Configurations

        • Create brand profiles that suit your business needs. You can also organize property listings by moving them between different brands for easier management. The workflow and pass criteria configured for each brand will be applied to all listings within that brand.
          image (2)
        • Define the criteria guests must meet to pass verification for each brand.
          image (3)
        • Customize the workflow for each brand, allowing for different verification processes based on specific needs.
          image (3)

          Please note that the import process may take additional time based on the number of listings in your account. We recommend allowing a few moments for all listings to populate fully.

      4. Operational Flow

        • Once a guest makes a reservation, a verification link is generated and added to the AuthenticatingVerifyURL custom field, irrespective of the reservation status.
          • The Medallion workflow through which the link takes the guest is dependent on the brand in Authenticate that the listing for which the reservation has been set as a part of.
        • The link can be sent to guests using a Guesty workflow, allowing hosts to control the distribution of the verification link.
        • Once the guest completes the verification process, the results and the status of any additional checks are immediately sent to the Guesty inbox.

      5. Custom Fields

        • AuthenticatingIDStatus: Displays the verification status of the guest's ID.
        • AuthenticatingCriminalReportStatus: Indicates the results of the 7-Year Criminal Check.
        • AuthenticatingVerificationPassed: A binary field indicating whether the guest's verification has passed based on predefined criteria.
        • AuthenticatingVerifyURL: Contains the URL sent to guests for self-verification.
        • AuthenticatingError: Provides details in case a check fails or requires further attention.

       

      Integrating Authenticate with Guesty simplifies guest identity verification and enhances the security of your property management. For further assistance or troubleshooting, please contact our support team.