Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
About Stripe payments
Upgrade your integration
Payments analytics
Online payments
OverviewFind your use caseManaged Payments
Use Payment Links
Build a checkout page
Build an advanced integration
Build an in-app integration
Payment methods
Add payment methods
Manage payment methods
Faster checkout with Link
Payment interfaces
Payment Links
Checkout
Web Elements
In-app Elements
Payment scenarios
Handle multiple currencies
Custom payment flows
Flexible acquiring
Orchestration
In-person payments
Terminal
Beyond payments
Incorporate your company
Crypto
Financial Connections
Climate
Understand fraud
Radar fraud protection
Manage disputes
    Overview
    How disputes work
    Handling
    Respond to disputes
    Manage disputes programmatically
      Visa Compelling Evidence 3.0
      Visa compliance
    Dispute withdrawals
    High risk merchant lists
    Analytics
    Measuring disputes
    Monitoring programs
    Optimization
    Dispute Prevention
    Smart Disputes
Verify identities
HomePaymentsManage disputesManage disputes programmatically

Visa compliance disputes

Use the API to respond to Visa compliance disputes.

Businesses receive Visa compliance disputes in certain cases when the card issuer believes the disputed transaction doesn’t conform to Visa’s network rules. If Visa compliance disputes can’t be resolved between the parties, the dispute is resolved by the network in exchange for a fee.

If you contest a Visa compliance dispute, in addition to the applicable Stripe dispute fees, Stripe collects a 500 USD (or local equivalent) amount to cover the network costs associated with resolving Visa compliance disputes. Stripe refunds the 500 USD if you win the dispute.

Note

Compliance cases filed by issuers are referred to as pre-compliance disputes by Visa.

Learn more about Visa rules.

Identify Visa compliance disputes

You can identify a Visa compliance dispute from the dispute object.

Use any of the following indicators to identify a Visa compliance dispute:

  • payment_method_details.case_type is set to compliance.
  • enhanced_eligibility_types contains visa_compliance.
  • reason is noncompliant.
{ "id": "du_TFCU9xJ2Gsj7BAiAoQok8Icp", "charge": "ch_vEUUPELhHVkPbMN1md3B0vG7", "enhanced_eligibility_types": ["visa_compliance"], "reason": "noncompliant", "payment_method_details": { "card": { "brand": "visa", "case_type": "compliance" } } }

Close Visa compliance disputes using the API

Closing a Visa compliance dispute indicates that you don’t have any evidence to submit and are essentially dismissing the dispute, acknowledging it as lost. You aren’t charged the 500 USD Visa compliance network fee if you choose to close the dispute.

To close a dispute, use the close API.

Warning

Closing a dispute is irreversible.

Respond to Visa compliance disputes using the API

The process of responding to a Visa compliance dispute is similar to responding to other disputes. You can use the update API to submit evidence to counter a dispute.

For Visa compliance disputes, you must explicitly acknowledge a 500 USD using the enhanced evidence object. Stripe withdraws the 500 USD network fee from your account when you submit evidence. Stripe refunds this network fee if you win the dispute.

To acknowledge the network fee, you must set evidence.enhanced_evidence.visa_compliance.fee_acknowledged to true when submitting evidence.

{ "id": "du_TFCU9xJ2Gsj7BAiAoQok8Icp", "charge": "ch_vEUUPELhHVkPbMN1md3B0vG7", "evidence": { ... "enhanced_evidence": { "visa_compliance": { "fee_acknowledged": true }, } ... }

If you acknowledge the Visa compliance network fee, evidence_details.enhanced_eligibility.visa_compliance.status changes to fee_acknowledged, indicating your acknowledgement.

{ "id": "du_TFCU9xJ2Gsj7BAiAoQok8Icp", "charge": "ch_vEUUPELhHVkPbMN1md3B0vG7", "evidence": { ... "enhanced_evidence": { "visa_compliance": { "fee_acknowledged": true }, }, "evidence_details": { ... "enhanced_eligibility": { "visa_compliance": { "status": "fee_acknowledged" }, } ... }

Warning

If you attempt to submit evidence for a Visa compliance dispute without acknowledging the network fee, Stripe returns an error response and doesn’t submit your provided evidence.

Testing

To test responding to Visa compliance disputes, use the following test card, which creates a Visa compliance dispute:

Testing MethodToken
Card Number
PaymentMethodpm_card_createComplianceDispute
Tokentok_createComplianceDispute

Similar to live mode Visa compliance disputes, Stripe returns an error response if you submit evidence without acknowledging the network fee.

Note

To simulate a won or lost state for the overall dispute, set uncategorized_text to winning_evidence or losing_evidence as outlined in Testing.

Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Join our early access program.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc