# 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 


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api.veratad.com/bouncer/bouncer-as-an-add-on.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.