For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
GuidesAPI Reference
GuidesAPI Reference
  • Network API
      • GETList disputes
      • GETRetrieve dispute
      • POSTAccept dispute
      • POSTChallenge dispute
      • GETList dispute evidence
      • POSTCreate dispute evidence text
      • POSTCreate dispute evidence file
      • DELDelete dispute evidence
      • GETRetrieve dispute evidence
      • Dispute
      • DisputeEvidence
      • POSTEvent: dispute.created
      • POSTEvent: dispute.status.updated
  • Customer Request API
  • Management API
LogoLogo
Network APIDisputes

Event: dispute.created

Payload
1{
2  "type": "dispute.created",
3  "event_id": "WE_9bvcp3ofi11trjjybr3il5i73",
4  "created_at": "2019-08-24T14:15:22Z",
5  "data": {
6    "id": "DSPT_1fbjn9dg7rmz1xeyv6gkyh8vg",
7    "object": {
8      "dispute": {
9        "id": "DSPT_1fbjn9dg7rmz1xeyv6gkyh8vg",
10        "payment_id": "PWC_4nn21zy6t0v2yhqg5bvhk7xkq",
11        "amount": 1000,
12        "reason": "FR10",
13        "settlement_withholding": "NOT_WITHHELD",
14        "state": "RESPONSE_REQUIRED",
15        "created_at": "2019-08-24T14:15:22Z",
16        "updated_at": "2019-08-24T14:15:22Z",
17        "merchant_id": "MMI_4vxs5egfk7hmta3qx2h6rp91x"
18      }
19    },
20    "type": "dispute"
21  }
22}

When is this event triggered?

This event is created whenever a dispute is created. This is caused by a customer filing a dispute concerning a payment collected by a merchant managed by this API client.

Was this page helpful?
Previous

Event: dispute.status.updated

Next
Built with

Payload

The payload of this webhook request is an object.
typestringRequired

The type of event that occurred. dispute.created for this event.

event_idstringRequired
A unique identifier provided by Cash App for the event.
created_atstringRequiredformat: "date-time"

When this event occured in RFC 3339 format (UTC).

The time that the event is delivered may be significantly later than this timestamp due to webhooks being retried for up to 72 hours.

dataobjectRequired
Data about the dispute that was created.

Response

200
any
Return a 200 status to indicate that the data was received successfully.