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 [email protected] or via your organization's shared Slack channel.

Docs & Guides    API Reference

Action Mapping

Action Mapping enables you to customize the business logic associated with Berbix transactions and can be thought of as the business decision after a verification. By default, Berbix includes three actions: reject, review, and accept. Review transactions populate the Default review queue.

An Action Map is associated with one or more Templates. Please create multiple templates if you need variable action mapping based on your use case or for testing purposes.

Actions are determined based on the logic defined in Verification Status Mapping and Flag Action Mapping. Berbix will prioritize the reject action over a review action and a review action over an accept action.

Verification Status Mapping

The ​status​ value of a ​photo ID verification represents whether or not a readable image was successfully collected from the user. There are two status values:

  • complete: all required components of the photo ID were collected successfully.
  • pending: the user exceeded the number of attempts to complete collection of one or more required components. In a pending result, one or more ID Flags will be returned to indicate why the ID verification was unsuccessful.

Verification Status Mapping lets you customize how the status value determines the action to take in your application. As shown in the example below, you might accept all complete transactions and reject all pending transactions notwithstanding any specific flag action mapping.

Flag Action Mapping

ID Flags indicate something of note with the photo ID verification. It doesn’t necessarily imply that the ID is fraudulent, but there is something important to consider when writing systems to accept or reject verifications. These are items such as id_under_18 or id_duplicated_detected.

A complete list of ID flags that Berbix returns can be found here: ID Flags

Flag Action Mapping lets you customize how the flags determine the action to take in your application. These mappings are highly dependent upon your business case and the actions you've defined. We're happy to help you define these mappings based on the best practices for your vertical and use case!

As an example, you may want to automatically reject transactions that return the id_under_21 flag if you're selling an age-restricted good.

Updated 5 months ago

Action Mapping

Suggested Edits are limited on API Reference Pages

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