You can generate your API keys by visiting the Berbix Dashboard and navigating to your settings by clicking the gear icon in the top navigation.

Within Settings > API Keys you can create a new API Key pair by clicking Add Key and selecting the API Key type as either Live or Test. A Client ID and Client Secret pair will be automatically generated.

Live API Keys should be used in production environments and Test API keys should be used in testing environments.

Please contact us at support@berbix.com if you have not yet received access to the Berbix dashboard.

To prevent misuse of your API credentials, the Allowed Domains list whitelists a specified set of domains from which you expect to serve Berbix Verify. In the event that we see a request for verification from an unspecified domain, we’ll return an API error when opening the verification flow.

To add a domain, simply click Add Domain, provide your domain name and click Submit.

Team settings presents the list of all Team Members that have access to the Berbix Dashboard and their respective roles. You can also Invite new team members from this view as an Admin.

There are three roles available:

1. Admin: can edit all settings.
2. Developer: can edit all settings with the exception of Team and Billing settings.
3. Agent: can only edit manual review actions.

Webhooks fire to a specified endpoint when a transaction event occurs. There are two types of transaction events:

• Verification finished: when the user completes a verification.
• Verification status changed: when the verification status changes.

The action associated with the event will be included in the webhook payload.

The example below shows a sample notification webhook payload which includes:

• id: webhook event ID.
• user_id: deprecated field (please use transaction_id)
• transaction_id: ID for associated transaction
• customer_uid: customer UID associated with the transaction
• action: actions associated with the transaction.

Your payment plan and credit card information can be managed from billing settings if paying by monthly credit card.

Notifications let you configure what Queues should trigger notifications when transactions are added to them. They should be used to notify individuals to visit the Berbix Dashboard to manually review a transaction in a review queue.

There are two notification types:

• Email: sends an email notification to a given email address.
• Webhook: delivers a webhook to a given endpoint.

In the example below, Berbix will notify foo@bar.com via email for new transactions add to the Rejections queue and deliver a webhook to http://example.com/api/berbix for new transactions added to the Accepted queue.

The example below shows a sample notification webhook payload which includes:

• user_id: deprecated field (please use transaction_id)
• transaction_id: ID for associated transaction
• code: an authorization code that can be used to create new access tokens for the transaction. Please see Create access token for details on how to pass your authorization_code to the /tokens endpoint.
• dashboard_link: Berbix dashboard URL for transaction. Please see Transactions to review all the data that is shown on the transaction page.