# Bouncer as an add-on

Bouncer it excels when added to your existing verification services. By doing so, all incoming transaction data is automatically captured and evaluated against the stored dataset, allowing you to run a variety of rules in real time.

## Request

To invoke Bouncer as an add-on, append `.Bouncer` to the end of the service name in your request:

```json
{
  "user": "username",
  "pass": "password",
  "service": "IDMatch5.0.Bouncer",
  "target": {
    // PII or transaction-related parameters
  }
}
```

## Response

When bouncer is activated your request and response structure remain the same. You will just see new details that appear when a rule is triggered. See below. 

```json
{
    "meta": {
        "confirmation": 71483084,
        "reference": "12345",
        "service": "IDMatch5.0.Bouncer",
        "timestamp": "2024-10-17 14:29:48",
        "company": "Company, LLC",
        "user": "ws@company.com"
    },
    "result": {
        "action": "FAIL",
        "detail": "TARGET ALREADY VERIFIED",
        "issues": []
    }
}
```

## Actions and Details

| Action | Detail                           | Explanation                                               |
| ------ | -------------------------------- | --------------------------------------------------------- |
| FAIL   | TARGET ALREADY VERIFIED          | The user has been marked as verified and cannot proceed.  |
| FAIL   | TARGET ATTEMPTS EXCEED THE LIMIT | The user has exceeded the permissible number of attempts. |
| FAIL   | TOO MANY QUIZZES                 | The user has attempted more quizzes than allowed.         |
| FAIL   | QUIZ CANNOT BE GENERATED         | The system could not produce a new quiz for the user.     |

## Default Rules

All rules are customizable, please discuss with your Veratad professional services team member, but by default the following are put into place. 

* Velocity: A customer can run 3 transactions within 24 hours 
* Already Verified: A customer can have 1 `PASS`event within 365 days 
* KBA: A customer can only see a question one time in 365 days 
* KBA: A customer can only have 2 quizzes in 365 days