Structure of a Rule in Buckaroo Shield

A rule consists of an if/then statement between a condition and an action.

If [Condition] Then [Action]


Condition

A condition consists of one or more expressions combined with AND or OR operators.

Example Condition:

[Expression A] AND [Expression B] OR [Expression C]


Action

There are three possible actions to choose from:

ActionDescription
WarnA warning is given for the transaction
RefuseThe transaction is refused, or will be automatically refunded in the case of an After-The-Fact refusal
ExemptThe transaction is exempted from Shield rules and lists

Expressions

An expression is a combination of datapoints/functions and relational operators.

Expression Examples:

  1. Example 1:

[Datapoint A] [relational operator] [Datapoint B]

  • Card number country equals Client IP Country
  1. Example 2:

[Datapoint A] [relational operator] [value]

  • Amount greater than 300
  1. Example 3:

[Function] [relational operator] [value]

  • Card number attempts within 5 minutes greater than 3

Functions

FunctionDescription
Card numbers attempted from client IPCount of unique debit or credit card numbers used per Client IP per time interval
Gift card attempts from client IPCount of unique gift card numbers used per Client IP per time interval
Payment attemptsCount of payment attempts per Client IP per time interval
Card numbers attempted from client IP (global)Count of unique debit or credit card numbers used per Client IP per time interval, across all Buckaroo merchants
Gift card attempts from client IP (global)Count of unique gift card numbers used per Client IP per time interval, across all Buckaroo merchants
Card number originates from unknown countryCard number country could not be identified
Client IP originates from unknown countryClient IP country could not be identified

Relational Operators

OperatorExample
Contains textCard number contains text 5561
EqualsCard number type equals ChargeCard
Greater thanAmount greater than 500.00
Greater than or equalAmount greater than or equal 500.00
Less thanAmount less than 1.00
Less than or equalAmount less or equal 1.00
Not equalsCard number brand not equals Mastercard
Occurs inCard number brand occurs in UnionPay, Rupay, Belkart