Multiple Updates

New rule_results in Transaction Event

Beginning on December 17, 2024, a new array, rule_results, will be added to the event schema of the transaction object. This list provides additional details for transactions declined as a result of a rule executed by Lithic. This information will be most relevant for customers utilizing Authorization Rules to manage their authorization strategy, but may also be populated for any customer if a transaction is declined due to mandatory Lithic risk or compliance rules.

Details

The rule_result array includes the following fields:

• auth_rule_token: UUID of the rule responsible for the decline or null if the decline was due to a Lithic-configured rule.
• name: Name of the authorization rule, if configured.
• result: Details about the rule's evaluation outcome.
• explanation: Human-readable explanation for the decline.

Example

"rule_results": [
  {
    "auth_rule_token": "ef49df0c-ed17-44cb-811b-6de1ec0f088a",
    "name": "Block foreign country rule",
    "result": "DECLINE",
    "explanation": "The conditional block rule declined the transaction because the COUNTRY value of CAN failed the parameter evaluation of COUNTRY IS_NOT_ONE_OF USA."
  }
]

Note

This change is purely additive and will not affect existing integrations. No new rules are configured as part of this change, only improved visibility is provided into existing rules. For more information about this addition, please see the API Reference.

New excluded_card_tokens in Authorization Rules

Beginning on December 10, 2024, a new array, excluded_card_tokens, will be available in the Authorization Rule schema. This field allows customers to create rules that apply program-wide, while excluding specific cards from the rule's application. This enhancement provides greater flexibility for customers managing Authorization Rules across their programs.

Details

• Field Name: excluded_card_tokens
• Type: Array of strings
• Description: A list of card tokens (UUIDs) that are exempt from the rule's application.

Note

This update is additive and will not impact existing integrations. This new field applies only to users of the Lithic Authorization Rules product. For more information about the excluded_card_tokens field, please refer to the Authorization Rules API reference.

If you have any questions or concerns, please contact us via the HELP link in your Lithic Dashboard.

The Lithic changelog has an RSS feed! To monitor for new update announcements, subscribe with your preferred RSS reader.