BDI

This feature needs to be activated. Please inquire details with our support.

BDI integration refers to “Coface bdi“. This integration include out-the-box data exchange with coface based on data inserted into a form. The flow is:

1. User insert a data, i.e. loan amount, id etc..
2. Data is posted securely to coface
3. Result is returned to form so further implementation can be carried out such as hide or show parts of the form based on success or failure

What needs to be done prior to the following steps?

1. Make sure you have an API account with BDI for personal check. make sure the following data handy: Username, password, Terminal ID, Credit provider code
2. Make sure you have received clearance to use BDI from our support team

How to set up BDI

Once BDI is available for your disposal please carry out the following configuration

Setup web-hook

1. Login to cellosign app and click to add new web hook from web hook pane
2. Provide a name for your integration
3. Select type: “Get data from remote source” (Field change API)
4. Turn off switch “Use implicit”
5. Insert URL provided.
6. Add the following header and corresponding values
   • “X-BDI-TermID”: Value is the terminal ID provided from BDI
   • “X-BDI-CreditProviderCode”: Value is your credit provider code you received from BDI
7. In authentication section, Select “Basic” and enter the username and password you received from BDI

Note: Parameters are encrypted and are not displayed in cellosign interface

Template configuration

Select the template that requires integration with BDI and follow these steps

1. Open integrations tab
2. Click “Add live connector”
3. Select Webhook for source
4. Select the webhook you created in previous stage (by name)
5. Select the trigger: Field change or click. We advise to use click.
6. Add the following fields to the mapper. make sure that the configuration includes the field name or alias exactly as in alias column (Note capital and small letters)

Alias	What it does	Notes and data validation
FirstName	Client first name	Outgoing, Mandatory Make sure to set “Hebrew characters” only in field configuration
LastName	Client last name	Outgoing, Mandatory Make sure to set “Hebrew characters” only in field configuration
ID	Client ID number	Outgoing, Mandatory Make sure to select Cellosign ID field
result	This is the options for returning values – “1” success (related to cwa_code) – “2” error. This represents a legitimate error. Details can be retrieved from the following parameters – “9999” Unexpected error. Interface not available or any technical error, Typically this is not related to client data.	Incoming Mandatory.
bdi_error_code	Retrieve value from “ErrCode” in “BDI_Error” object	Incoming, Optional
bdi_error_desc	Retrieve value from “ErrDescription” in “BDI_Error” object	Incoming, Optional
ccr_error_code	Retrieve value from “Code” in “CCR_Error” object	Incoming, Optional
ccr_error_desc	Retrieve value from “Description” in “CCR_Error” object	Incoming, Optional
ccr_error_sev	Retrieve value from “Severity” in “CCR_Error” object	Incoming, Optional

Limitations

1. interface support Israeli ID, Passport is not supported
2. Interface is limited to personal check. Company