Skip to main content

Disputes Overview

Disputes (also known as chargebacks) occur when a cardholder questions a payment with their card issuer. The JustiFi Dispute API provides comprehensive tools to manage the entire dispute lifecycle, from initial notification through resolution.

Key Features​

  • Unified Management: Handle disputes across all payment gateways through a single API
  • Evidence System: Upload supporting documents via secure S3 presigned URLs using a web component or API
  • Real-time Tracking: Monitor dispute progress with webhook notifications
  • Comprehensive Response: Submit detailed responses with 20+ evidence fields
  • Automatic Reversals: System handles card network dispute reversals, including issuer appeals after a win
  • Test Environment: Full-featured sandbox for testing dispute workflows

Getting Started​

  1. Set up a webhook endpoint in your application to receive dispute notifications.
  2. Create a webhook in the JustiFi Portal in the "Developer" section in the user menu https://portal.justifi.tech/developer/webhooks, then click Add Webhook and subscribe to dispute events
  3. Implement dispute response workflows in your application via Dispute Management Web Component or via disputes API
  4. Test the complete dispute lifecycle using the test environment as described below