# Experian integration

Use the Experian integration for identity proofing. For more information about this integration, see [Identity proofing](https://www.experian.com/decision-analytics/identity-proofing).

To complete this guide, you must have Experian account credentials.

## Integrate Experian

This guide describes how to integrate Experian with Rebilly.

### 1. Connect an Experian account to Rebilly

This process describes how to connect your Experian account to Rebilly.

1. In the left navigation bar, press , then press **Experian**.
2. Press **Add Experian credentials**.
3. Enter your: username, password, HMAC key, and public key.
4. Press **save**.


### 2. Create tags

This step describes how to create tags that will be used to tag your customers based on the result of the Experian check.

1. In the left navigation bar, press .
2. In the **Management** section, press **Tags**.
3. Add 3 new tags, one for each Experian result: confirmed, rejected, or unknown. We suggest using the following tags:
  - `experian-confirmed`
  - `experian-rejected`
  - `experian-unknown`


### 3. Create Experian check rules

This step describes how to create an automation that trigger the Experian check based on the customer's billing address and date of birth, and assigns the corresponding tag based on the result.

1. In the left navigation bar, press .
2. In the **Rules engine** section, press **Rules engine**.
3. Press **Core events**.
4. Press the **Transaction process requested** event.
5. Press **Rule set**, then press **Create rule**.
6. In **Name** field, enter a name for the rule.
7. Clear the **Stop further processing** checkbox.
8. In the **Conditions** section, clear the **No conditions** checkbox, and apply the following filters:
  - Transaction > Billing address > Country `is in` DE - Germany.
  - Transaction > Customer > Primary Address > Dob `is not empty`.
  - Transaction > Customer > Tags > Name `is not in` experian-confirmed `and` experian-rejected `and` experian-unknown.
9. In the **Actions** section, press **Add action**, and select the **Perform Experian check** action.
10. Select your Experian service credential.


1. Assign the tags you created in [step 2](#2.-create-tags) to each Experian result.
2. Press **Save rule**.
3. Adjust the position of the rule to ensure it is executed, and to ensure that this rule does not stop additional rules processing.


![Experian check rule](/assets/experian-check-rule.4be77f4530d53655096dc39fc42c24dc18681187da09d014cd5d80c3af6b8902.a8224ebd.png)

### 4. Create an approval notification

This step describes how to set up notifications for approved Experian check events using webhooks.

1. In the left navigation bar, press .
2. In the **Rules engine** section, press **Rules engine**.
3. Press **Core events**.
4. Press the **Experian check performed** event.
5. In **Name** field, enter a name for the rule.
6. In the **Conditions** section, clear the **No conditions** checkbox, and apply the following filter:
  - Customer > Tags > Name `is in` experian-confirmed.
7. In the **Actions** section, press **Add action**, and select the **Send webhook** action.
8. Enter your webhook settings, then press **Save rule**.


To set up notifications for declined or unknown Experian check events, repeat this process and filter for the corresponding tag.

You may use placeholders in the webhook URL, headers, body, or query parameters:

- `customerId`
- `outcome`
- `reason`
- `errorCode`
- `errorMessage`


This example of a webhook body uses two placeholders:


```json
{
  "customerId": "{{ customerId }}",
  "outcome": {{ outcome }}
}
```

For more information, see the [Experian check performed event](/docs/dev-docs/api/customers/experian-check-performed).