Disputes API

Manage and track transaction disputes and chargebacks.

API Version

Overview

The Disputes API allows you to programmatically handle transaction disputes initiated by your cardholders. You can create a dispute against a specific transaction and track its status through the resolution process.

API Endpoints

POST/api/v1/b2b/disputes/create

Creates a new dispute for a given transaction.

Request Body

JSON

{
  "transaction_reference": "TXN_1A2B3C",
  "reason": "The merchant charged the incorrect amount. The correct amount was $15.00.",
  "amount": 10.50
}

Success Response

JSON

{
  "success": true,
  "message": "Dispute created and is under review.",
  "disputeId": "disp_a1b2c3d4e5f6"
}

GET/api/v1/b2b/disputes/{disputeId}/status

Retrieves the current status of a specific dispute.

Example Response

JSON

{
  "success": true,
  "disputeId": "disp_a1b2c3d4e5f6",
  "status": "UNDER_REVIEW",
  "last_update": "2024-05-22T10:00:00.000Z"
}