payment.disputed

{ "event": "payment.disputed", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "paymentTransactionId": "txn_q7r8s9", "provider": "stripe", "paymentLinkId": null, "invoiceId": "inv_n4o5p6", "invoiceNumber": "INV-0043", "customerId": "user_123", "subscriptionId": "sub_1a2b3c4d", "disputeAmount": 9900, "currency": "usd", "disputeReason": "fraudulent" } }

When this fires

When the cardholder’s bank notifies the payment provider that a charge is being disputed (a chargeback). The disputed amount is frozen from your payout balance while the dispute is open. As the Merchant of Record, Commet handles the evidence and resolution process with the provider.

disputeAmount is the contested amount in cents; disputeReason is the provider’s reason code (for example fraudulent or product_not_received), or null when the provider gives none.

The resolution fires payment.dispute_resolved with the outcome. Use this event to flag the account internally — repeated disputes are a strong fraud signal.

Body

application/json

string

required

event

string

required

Allowed value: "payment.disputed"

timestamp

string

required

organizationId

string

required

mode

enum<string>

required

Available options:

live,

sandbox

apiVersion

string

required

data

object

required

Show child attributes

Response

200

Return any 2xx status code to acknowledge receipt of the event.

Overview

Events

payment.disputed

When this fires

Body

Response

​When this fires

Body

Response

When this fires