Dispute Webhooks

Using the webhook, merchant application can get real time updates on the dispute status and dispute related events.

Disputes

Supported Events

Event Type	Description	Applicable payment method types
DISPUTE_WON	Emitted when dispute is won and funds are reinstated.	CARD, BANK_ACCOUNT
DISPUTE_LOST	Emitted when dispute is lost. `	CARD, BANK_ACCOUNT
DISPUTE_INITIATED	Emitted when a dispute is created and funds are withdrawn.	CARD, BANK_ACCOUNT

Event Structure

Field	Type	Valid values	Description
name	Enum	DISPUTE_WON, DISPUTE_LOST, DISPUTE_INITIATED	Event name
payload	Payload		Event Payload

Payload Structure Sample

{
   "amount": 50,
   "eventType": "DISPUTE_INITIATED||DISPUTE_WON||DISPUTE_LOST",
   "merchantTransactionId": "3ecd813a-12dd-4135-ac4e-9f400d5181fb",
   "merchantId": "8e44f962-36bf-4eef-b80c-fd6a23029800",
   "evidence": {
      "access_activity_log": null,
      "billing_address": "IN",
      "cancellation_policy": null,
      "cancellation_policy_disclosure": null,
      "cancellation_rebuttal": null,
      "customer_communication": null,
      "customer_email_address": null,
      "customer_name": "Devender",
      "customer_purchase_ip": null,
      "customer_signature": null,
      "duplicate_charge_documentation": null,
      "duplicate_charge_explanation": null,
      "duplicate_charge_id": null,
      "product_description": null,
      "receipt": null,
      "refund_policy": null,
      "refund_policy_disclosure": null,
      "refund_refusal_explanation": null,
      "service_date": null,
      "service_documentation": null,
      "shipping_address": null,
      "shipping_carrier": null,
      "shipping_date": null,
      "shipping_documentation": null,
      "shipping_tracking_number": null,
      "uncategorized_file": null,
      "uncategorized_text": null
   },
   "reason": "FRAUDULENT",
   "status": "NEEDS_RESPONSE",
   "paymentType": "CARD",
   "balanceTransactions": [
      {
         "amount": -50,
         "available_on": 1716854400,
         "created": 1716283111,
         "currency": "usd",
         "description": "Chargeback withdrawal for ch_3PIoq2I4dYE13Vva13lNTr3y",
         "exchange_rate": null,
         "fee": 1500,
         "fee_details": [
            {
               "amount": 1500,
               "application": null,
               "currency": "usd",
               "description": "Dispute fee",
               "type": "stripe_fee"
            }
         ],
         "id": "txn_1PIoq3I4dYE13VvaWkU6uYvT",
         "net": -1550,
         "object": "balance_transaction",
         "reporting_category": "dispute",
         "source": "dp_1PIoq2I4dYE13Vva263rszkj",
         "status": "pending",
         "type": "adjustment"
      }
   ]
}