New Enum Value in Settlement API

Overview

We are introducing a new COLLABORATION value to the type field in settlement details provided through our Settlement API. This change better categorizes credits issued through Mastercard's dispute collaboration process.

Details

What is Collaboration?

Collaboration is a process within the Mastercard dispute resolution cycle that aims to resolve disputes early, before a chargeback is submitted. A COLLABORATION settlement detail represents a credit issued over Mastercard's dispute management platform during this collaboration stage.

What's Changing

Currently, collaboration credits appear as settlement details with:

• type: FEE
• fee_description: ACQ. COLLABORATION - FT (FUND TRANSFER) BY MASTERCOM REF NO. XXX ARN: XXX

Starting October 21, 2025, these will instead appear with:

• type: COLLABORATION

Note: Customers who have already received collaboration-related settlement details have been notified in advance. If you have not previously encountered settlement details with the fee description pattern shown above, you are unlikely to encounter this new enum value in the future; that said, you are advised to handle it gracefully as a precaution.

Timeline

• This week: Updated SDKs will include the new COLLABORATION enum value
• Now through October 21, 2025: Update and test your integration to handle the new enum value
• October 21, 2025: Earliest date when COLLABORATION settlement details may begin appearing in production

Action Required

Please ensure your systems are prepared to handle COLLABORATION as a valid value for the type field by October 21, 2025. If you use our SDKs, you can update to the latest version once available this week.

If you have any questions, 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.