Skip to navigation
ReferenceFeaturesProvisioningConnector routingRule conditions

ChargebackCountOrVolumePerConnector

Matches when the chargeback count or volume — at the merchant level or for a specific connector — over a configured time window crosses a configured threshold. Shown as “Chargeback count/volume per merchant/connector” in the condition catalogue. Use to route away from connectors with elevated chargeback levels.

Parameters

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

FieldTypeAllowed values
valueReferencestring"merchant" to count merchant-wide, or a connector GUID to count only that connector’s chargebacks
valueUnitstring"count" (number of chargebacks) or "volume" (sum of chargeback amounts)
timeReferencestringA numeric string indicating how many units of time to look back, e.g. "7" (window capped at 61 days)
timeUnitstring"seconds", "minutes", "hours", "days"
comparatorstring"=", ">", ">=", "<", "<="
valuestringThe threshold to compare against, as a numeric string, e.g. "5"

Example

Match when the merchant has had more than 5 chargebacks in the last 7 days:

{
  "constraint": "ChargebackCountOrVolumePerConnector",
  "params": {
    "valueReference": "merchant",
    "valueUnit": "count",
    "timeReference": "7",
    "timeUnit": "days",
    "comparator": ">",
    "value": "5"
  }
}

Notes

  • Availability: might not be included in your platform package — if this condition is missing from the catalogue returned by List routing constraints, contact your Customer Success Manager to have it activated.
  • Use "merchant" as valueReference to count chargebacks 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. "7", "5"), 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.