Berbix

Berbix Docs

Welcome to the Berbix docs! Here you’ll find comprehensive information for integrating Berbix Verify and its associated APIs as well as an overview of Berbix Dashboard functionality.

The fastest way to integrate Berbix Verify is to follow our Integration Guide, which walks through your entire Berbix integration step-by-step. You’ll integrate Berbix Verify into your site or app and then use one of our SDKs to retrieve the data you need from our API. You'll also be guided through the configuration of verification workflow rules to map to your existing business logic.

You can see the full Berbix Verify API specification in our API Reference Docs and find functional documentation for the Berbix Dashboard here.

If you have any questions, please don't hesitate to reach out to us at support@berbix.com or via your organization's shared Slack channel.

Docs & Guides    API Reference

Transactions

View All Transactions

A transaction refers to a unique user that has initiated a verification through Berbix Verify. The history of all transactions for your account is available in the Transactions tab within the Berbix Dashboard.

Within this view, you're presented the unique Berbix UID for each transaction, your Customer UID, the type of verification(s) included in the transaction and when the transaction was created.

You can also filter by the type of verification as well as for test or live transactions only. Berbix offers verifications for Photo ID, Address, Email, Phone, and Details (Personal Details).

Filter by CustomerUID

Within the transactions view, you can filter for a given customer UID to find all transactions for that user.

View an Individual Transaction

Basic Info

The top of the view for an individual transaction will present a variety of basic information about the transaction. This includes:

  • User Info: Name, Date of Birth, Age, etc.
  • Document Info: Document Type, Expiry Date, Issue Date, etc.
  • Session Info: Referrer, IP, Location, etc.
  • Flags: ID Flags returned for the transaction color-coded based on their action mapping. The mapped action is also shown at the top of the transaction in its associated color.

In the example below, the provided ID is a sample ID which returned the flag id_sample_detected mapped to the review action.

Document Details

Beneath the basic info, you'll be presented the user provided front and back images of the ID that can be used for manual review.

Face Match

Beneath the document details, Berbix provides a cropped photo from the Photo ID alongside the user provided selfie and liveness check image (if enabled). The document photo will be compared to the selfie image and the selfie image will also be compared to the liveness check.

In the example below, the provided selfie was an unlikely match when compared to the document photo but was a likely match when compared to the liveness check image. The unlikely match also caused Berbix to return the id_selfie_face_mismatch flag, which was mapped to the review action.

Watermarking

Images exposed in the dashboard (and via the API) are watermarked in an effort for Berbix to be the best possible steward of sensitive data. Image watermarks are generated on a per-access basis and therefore can be traced to the IP address accessing the image and the timestamp at which the image was accessed. Each image includes two watermarks: one in the bottom-left corner and one that covers the sensitive data in the image (such as an ID or a face). The IP address and timestamp associated with the image are also rendered in a notice at the bottom of the image to discourage storing or sharing of this sensitive information.

Watermarked images are also surfaced at a lower resolution than that of the original raw image. Please contact us if the resolution or watermark prevents you from reviewing the contents of a given ID or selfie image!

Transactions

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.