Back to Home

Documentation

Learn how to use Vantirs to protect your business from chargebacks

How Vantirs Works

1

Automatic Dispute Detection

When a chargeback is filed, Stripe automatically notifies Vantirs via webhook. We immediately begin analyzing the dispute.

2

CE 3.0 Eligibility Matching

Vantirs searches your historical transactions (120-365 days) to find matches based on device fingerprints, IP addresses, and customer IDs. If 2+ matches are found, the dispute is eligible for CE 3.0 liability shift.

3

Evidence Generation

For eligible disputes, Vantirs automatically generates a bank-admissible compliance report (PDF) with structured tables, historical transaction matches, and usage audit logs.

4

Automatic Submission

Evidence is automatically submitted to Stripe on your behalf. You can also manually review and submit disputes through the dashboard.

5

VAMP Protection

Disputes won via CE 3.0 are automatically removed from your VAMP ratio calculation, helping you stay below the 1.5% threshold.

Dashboard Features

Real-Time Statistics

Your dashboard shows:

  • Total disputes and their status
  • Recoverable amount (disputes eligible for CE 3.0)
  • Win rate and success metrics
  • Total transaction volume

VAMP Ratio Monitor

Track your dispute ratio in real-time against the 1.5% threshold. Visual indicators show when you're approaching the limit, with automatic alerts when exceeded.

Dispute Queue

View all your disputes in one place with:

  • Compliance scores (0-100) for each dispute
  • CE 3.0 eligibility status
  • Network information (Visa, Mastercard)
  • Dispute amounts and dates
  • One-click PDF download
  • Manual evidence submission option

Compliance Reports

Download bank-ready PDF compliance reports for any dispute. Reports include structured tables, historical matches, and usage audit logs formatted for bank OCR scanning.

Key Features

Automatic CE 3.0 Matching

Searches 12 months of transaction history to find eligible disputes automatically

Forensic Evidence Generation

Creates bank-admissible PDF reports with structured tables and historical matches

Automatic Evidence Submission

Submits evidence to Stripe automatically for eligible disputes (with manual review option)

VAMP Ratio Protection

Monitors your dispute ratio and removes CE 3.0 wins from calculations

Mastercard FPT Support

Special handling for Mastercard First-Party Trust disputes with stricter matching requirements

Historical Transaction Sync

Sync up to 12 months of past transactions for comprehensive CE 3.0 matching

Using the API

Authentication

All API requests require your API key in the header:

Authorization: Bearer vant_xxxxxxxxxxxx

Get Dashboard Statistics

Retrieve your dispute statistics and metrics:

GET https://vantirs.com/api/dashboard/stats
Authorization: Bearer vant_xxxxxxxxxxxx

Returns: Total disputes, recoverable amount, win rate, VAMP ratio

List All Disputes

Get all your disputes with compliance scores:

GET https://vantirs.com/api/disputes
Authorization: Bearer vant_xxxxxxxxxxxx

Returns: Array of disputes with status, compliance scores, and eligibility

Download Compliance Report

Download the PDF compliance report for a specific dispute:

GET https://vantirs.com/api/disputes/{dispute_id}/pdf
Authorization: Bearer vant_xxxxxxxxxxxx

Returns: PDF file with compliance report

Submit Evidence Manually

Manually submit evidence for a dispute:

POST https://vantirs.com/api/disputes/{dispute_id}/submit
Authorization: Bearer vant_xxxxxxxxxxxx
Content-Type: application/json

{
  "custom_context": "Additional context for this dispute"
}

Submits evidence to Stripe and returns submission status

Compliance & Regulations

CE 3.0 (Visa)

Visa's Compelling Evidence 3.0 program allows liability shift for disputes when:

  • 2+ historical transactions (120-365 days old) match the disputed transaction
  • Matches are based on device fingerprint, IP address, or customer ID
  • Evidence is submitted within the required timeframe

Benefit: Won disputes are removed from your VAMP ratio calculation.

Mastercard FPT

Mastercard's First-Party Trust program has stricter requirements:

  • Requires device fingerprint AND (customer ID OR IP address) matches
  • Emphasizes "Service Delivery" evidence (login, exports, API calls)
  • 2+ historical transactions within 120-365 day window

VAMP Threshold

The Visa Acquirer Monitoring Program (VAMP) threshold drops to 1.5% on April 1, 2026. Merchants exceeding this threshold face $8 per dispute penalties. CE 3.0 wins help keep your ratio below the threshold.

Important Information

  • April 1, 2026 Deadline

    VAMP threshold drops to 1.5% (from 2.2%). Start protecting your business now.

  • CE 3.0 Requirements

    Need 2+ historical transactions 120-365 days old with matching fingerprints. Vantirs automatically finds these matches.

  • Automatic vs Manual

    Disputes over $500 are flagged for manual review. You can add custom context before submission.

  • No Guarantees

    While Vantirs identifies eligible disputes and generates evidence, final outcomes are determined by Stripe and card networks.

Need help getting started? View Setup Guide or Security Documentation