> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://ixopay.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ixopay.ferndocs.com/_mcp/server.

# DebitPreauthCountOrVolumePerConnector

Matches when the debit / preauthorize count or volume — at the merchant level or for a specific connector — over a configured time window crosses a configured threshold. Shown as "Debit/Pre-Authorization count/volume per merchant/connector" in the condition catalogue. Use to route away from connectors that have reached a volume cap.

## Parameters

All six parameters are required and sit at the top level of `params`.

| Field            | Type   | Allowed values                                                                                          |
| ---------------- | ------ | ------------------------------------------------------------------------------------------------------- |
| `valueReference` | string | `"merchant"` to count merchant-wide, or a connector GUID to count only that connector's transactions    |
| `valueUnit`      | string | `"count"` (number of transactions) or `"volume"` (sum of transaction amounts)                           |
| `timeReference`  | string | A numeric string indicating how many units of time to look back, e.g. `"24"` (window capped at 61 days) |
| `timeUnit`       | string | `"seconds"`, `"minutes"`, `"hours"`, `"days"`                                                           |
| `comparator`     | string | `"="`, `">"`, `">="`, `"<"`, `"<="`                                                         |
| `value`          | string | The threshold to compare against, as a numeric string, e.g. `"1000"`                                    |

## Example

Match when a specific connector has processed more than 1000 of volume in the last hour:

```json
{
  "constraint": "DebitPreauthCountOrVolumePerConnector",
  "params": {
    "valueReference": "CO-1234-5678-...",
    "valueUnit": "volume",
    "timeReference": "1",
    "timeUnit": "hours",
    "comparator": ">=",
    "value": "1000"
  }
}
```

## Notes

* **Availability:** might not be included in your platform package — if this condition is missing from the catalogue returned by [List routing constraints](https://documentation.ixopay.com/api/provisioning/list-routing-constraints), contact your Customer Success Manager to have it activated.
* Use `"merchant"` as `valueReference` to count across all of the merchant's connectors. To scope to a specific connector, pass that connector's GUID instead.
* `timeReference` and `value` are sent as numeric strings (e.g. `"1"`, `"1000"`), not as JSON numbers.
* `valueUnit` and `timeUnit` use lowercase values (`"count"` / `"volume"` and `"seconds"` / `"minutes"` / `"hours"` / `"days"`).
* The look-back window is capped at 61 days — larger values are treated as 61 days.
* Available for routing meta-connectors only — not in multi-method routing documents.