Dispute resolution rules
Learn about writing dispute resolution rules in Radar.
Starting May 1, 2025, you can use Radar to automatically resolve specific disputes. If you’re signed up for dispute prevention, you can write resolution rules to refund a dispute. Radar evaluates each incoming dispute against the dispute resolution rules you create. If a dispute matches the criteria for any rule, we automatically resolve it.
Rule structure
Dispute resolution rules follow the same rules structure as other Radar rules. The rule structure has two components—the action to take and the condition to evaluate:
{action} if {condition}
Together they represent the predicate. A rule to automatically resolve all incoming disputes with a disputed amount of 10 USD or less appears as:
Resolve Dispute if :amount_in_usd: <= 10.00
- The action is
Resolve Dispute - The condition is
:amount_in_ usd: < 10. 00
For all dispute resolution rules, the action is Resolve Dispute. Learn more about writing effective rules in Radar.
Supported attributes
Use the following attributes within Radar to write dispute rules.
Attribute | Type | Example Value |
card_bin | Case Insensitive String | 483312 |
The Bank Identification Number (BIN) of the card used to make the payment. The BIN is the first six digits of the card number. | ||
card_brand | Case Insensitive String | visa |
The brand of the card used to make the payment. The supported values are: amex (American Express), visa (Visa), mc (Mastercard), dscvr (Discover), diners (Diners Club), interac (Interac), jcb (JCB), and cup (UnionPay). | ||
card_country | Case Insensitive Country | US |
The two-letter code corresponding to the country where the card was issued. | ||
statement_descriptor | Case Insensitive String | example descriptor |
The statement descriptor provided on a payment. | ||
currency | Case Insensitive String | usd |
The 3-digit currency code representing the currency in which the customer paid for the transaction. | ||
amount_in_xyz | Numeric | 50 |
The amount of the payment, converted to the currency specified by xyz (for example, amount_in_usd). Specify one of the following supported currencies and Stripe automatically calculates a converted amount to use: aed, ars, aud, brl, cad, chf, clp, cop, czk, dkk, eur, gbp, hkd, huf, idr, ils, inr, jpy, khr, krw, mxn, myr, nok, nzd, php, pln, ron, rub, sek, sgd, thb, try, twd, or usd. For decimal currencies (for example, usd), rules use the base currency unit rather than sub units (for example, dollars, not cents). | ||
network_reason_code | Case Insensitive String | none |
The reason code from the network. Currently, only Visa dispute network reason codes are supported. | ||
amount_in_xyz | Case Insensitive String | 50 |
Identifies whether the dispute was filed as fraudulent or not fraudulent. The supported values are: fraudulent or non-fraudulent. | ||
is_fraudulent | Boolean | true |
Identifies whether the dispute was filed as fraudulent or non-fraudulent. Non-fraudulent disputes include disputes that were filed for reason categories, such as Product not received, Product unacceptable, and Subscription cancelled. | ||