Adds support for Mastercard compliance disputes
What’s new
Adds Mastercard compliance dispute support to the Disputes API. You can identify these disputes when enhanced_eligibility_types contains mastercard_compliance, or when payment_method_details.case_type is compliance, and the reason is noncompliant.
The evidence_details.enhanced_eligibility.mastercard_compliance object contains a status value of either requires_fee_acknowledgement or fee_acknowledged. To contest a Mastercard compliance dispute, include evidence.enhanced_evidence.mastercard_compliance.fee_acknowledged set to true when you submit evidence.
Impact
If your integration automatically submits dispute evidence, check for mastercard_compliance in enhanced_eligibility_types before submitting evidence. For Mastercard compliance disputes, close the dispute without incurring the network fee or update your evidence submission flow to set evidence.enhanced_evidence.mastercard_compliance.fee_acknowledged to true.
After you acknowledge the fee and submit evidence, evidence_details.enhanced_eligibility.mastercard_compliance.status changes to fee_acknowledged. We collect the Mastercard compliance network fee asynchronously and refund it if you win the dispute.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| mastercard_compliance | Added | Dispute#update. evidence. enhanced_evidence Dispute. evidence. enhanced_evidence Dispute. evidence_details. enhanced_eligibility |
| Value | Change | Enum |
| mastercard_compliance | Added | Dispute. enhanced_eligibility_types |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2026-06-24. dahlia
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.
Related changes
- Adds buyer ID support for Bizum payments
- Enables manual capture for Sunbit payments
- Adds buyer ID support for the related setting payments
- Adds a fingerprint to Pix payment method details
- Adds transaction link ID to card payment method details for Mastercard and Maestro transactions
- Adds payment method options for Sunbit in Checkout Sessions
- Adds support for the Sui network and USDsui token for crypto payments
- Adds support for recurring payments with Satispay