Home / Issuing / Control Authorizations

Configure Velocity Controls

Overview

Note: Refunds and reversals will not impact the cumulative amount on a velocity control.

Velocity controls allow time boundary constraints to be applied to a Spend Rule. The following example explains the difference between velocity controls and spend rules:

  • A payment card has a spend rule to decline all authorizations over $1,000.
  • For the same payment card, a velocity control is added to decline any authorizations that exceed $1,000 within a calendar week.
  • This creates a velocity control that enforces a weekly spending limit of $1,000.

The following graphic shows how a velocity control is created and applied at the card product and payment card levels:

AuthControlsImage.svg

Velocity control windows

You can set velocity control time frames using several time windows. The following table describes available velocity control windows:

Velocity Rule WindowDescription
DailyA single calendar day, 00:00:00 UTC to 11:59.59:00 UTC
WeeklyA single calendar week, UTC start of week (Monday) to UTC end of week (Sunday)
MonthlyA calendar month, UTC start of month to UTC end of month
Ninety days90 calendar days moving window. One calendar day is from 00:00:00 UTC to 11:59.59:00 UTC
YearlyA calendar year, UTC start of year to UTC end of year
Per transactionVelocity Rule is evaluated on every transaction individually

Limits

You can add three spend rules to a velocity control. Additionally, velocity controls have limits at the card product, financial account, and payment card levels:

  • Card product: Limit of 10 velocity controls per card product
  • Financial account: Limit of 10 velocity controls per financial account
  • Payment card: Limit of 10 velocity controls per payment card

Create velocity control

Note: An amount spend rule, or cumulative rule, is required to create a velocity control.

To create a velocity control, you must first create spend rules, and attach your spend rules to the velocity control. You can add up to three spend rules to a velocity control. Velocity controls authorize transactions based on whether the associated spend rule's conditions are met within the velocity control window.

The following example uses multiple spend rules to create a velocity control for airline purchases:

  1. Create an amount limit spend rule for $1000.
  2. Create a MCC spend rule for airline purchases.
  3. Add both spend rules to a monthly velocity control.
  4. Your velocity control will limit only airline purchases to $1000 a month.

Use the following mutation to create a velocity control:

Attach velocity control to a card product

Velocity controls can be attached to a card product or individual payment card. Attaching a velocity control to a card product applies the spend rules and velocity control to all financial accounts and payment cards for your card product.

Use the following mutation to create a velocity control for a card product:

Attach velocity control to a payment card

Velocity controls can be attached to a card product or individual payment card. Velocity controls attached to a payment card only apply to that specific payment card.

Use the following mutation to attach a velocity control to a payment card:

Detach velocity control from a card product

Note: If you detach and re-attach a velocity, the balance on the "count" and "windows" of the velocity control will reset.

Use the following mutation to detach a velocity control from a card product:

Detach velocity control from a payment card

Note: If you detach and re-attach a velocity, the balance on the "count" and "windows" of the velocity control will reset.

Use the following mutation to detach a velocity control from a payment card:

List velocity controls

Use the following query to find all velocity controls for your organization:

Find velocity control balance

Velocity controls track how much money has been spent within a certain window to help troubleshoot declined transactions. You can check the "balance" of a velocity control for a payment card or financial account. The balance reflects the total amount spent.

Use the following query to find the velocity control balance on a financial account:

Provide Feedback

Was this content helpful?