> This page is for Cash App Pay Partner API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.cash.app/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.cash.app/_mcp/server.

### Schema (`response.body`)

```yaml
openapi: 3.1.0
info:
  title: API
  version: 1.0.0
paths:
  /disputes/{dispute_id}/accept:
    post:
      operationId: subpackageDisputes_accept-dispute
      summary: Accept dispute
      description: >-
        Resolves a dispute by having the merchant accept responsibility for it.
        This leads to a "loss" of the dispute from the merchant's perspective,
        and a "win" of the dispute from the customer's perspective.


        <Note> 

        After a dispute is accepted, the decision is final; it can never be
        changed.

        </Note>


        **This endpoint is not rate limited.**


        Scopes: `DISPUTES_WRITE`
      tags:
        - subpackage_disputes
      parameters:
        - name: dispute_id
          in: path
          description: ID of the dispute to accept.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/disputes_AcceptDisputeResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
tags:
  - name: subpackage_disputes
servers:
  - url: https://api.cash.app/network/v1
    description: Production
  - url: https://sandbox.api.cash.app/network/v1
    description: Sandbox
components:
  schemas:
    disputes_DisputeReason:
      type: string
      enum:
        - FR10
        - FR11
        - PE10
        - PE11
        - PE12
        - CD10
        - CD11
        - CD13
      description: >-
        4-digit code consisting of 2 letters followed by 2 numbers that
        indicates why the dispute was created, at a high level.


        Current values:


        - `FR10`: Customer has no knowledge of the payment.

        - `FR11`: Customer has no knowledge of the payment and liability has
        shifted to the merchant due to collusion, fraud monitoring program
        thresholds, or any other reason.

        - `PE10`: Payment was processed twice.

        - `PE11`: Payment amount differs from agreed amount.

        - `PE12`: Payment was paid for by another means.

        - `CD10`: Cancelled services.

        - `CD11`: Goods or services differ from what was agreed upon for the
        payment.

        - `CD12`: The goods or services were not received.

        - `CD13`: The purchase was cancelled or returned, but the refund has not
        been processed.
      title: DisputeReason
    disputes_DisputeSettlementWithholding:
      type: string
      enum:
        - NOT_WITHHELD
        - WITHHELD_ALREADY
      description: >-
        Indicates if the disputed amount has already been withheld from a
        settlement or not.


        Current values:


        - `NOT_WITHHELD`: The disputed amount has not yet been withheld in a
        settlement. It may impact future settlements if the dispute is "lost" by
        the merchant.


        - `WITHHELD_ALREADY`: The disputed amount was withheld in a prior
        settlement. This dispute will not impact future settlements.
      title: DisputeSettlementWithholding
    disputes_DisputeState:
      type: string
      enum:
        - RESPONSE_REQUIRED
        - NO_RESPONSE_REQUIRED
        - PROCESSING
        - ACCEPTED
        - WON
        - PARTIALLY_WON
        - LOST
      description: |-
        The step in the dispute lifecycle that this dispute is currently at:

        - `RESPONSE_REQUIRED`
        - `NO_RESPONSE_REQUIRED`
        - `PROCESSING`
        - `ACCEPTED`
        - `WON`
        - `PARTIALLY_WON`
        - `LOST`
      title: DisputeState
    disputes_Dispute:
      type: object
      properties:
        id:
          type: string
          minLength: 1
          maxLength: 128
          description: |-
            A unique identifier for the dispute issued by Cash App.

            Min length: `1`
            Max length: `128`
        payment_id:
          type: string
          minLength: 1
          maxLength: 128
          description: |-
            ID of the disputed payment.

            Min length: `1`
            Max length: `128`
        amount:
          type: integer
          minimum: 1
          description: >-
            Amount of disputed money, in the lowest denomination of currency on
            the associated payment.


            Min value: `1`
        customer_credited_amount:
          type:
            - integer
            - 'null'
          minimum: 0
          description: >-
            The amount credited to the Customer after resolving the dispute. 


            Note: The amount will be in the lowest denomination of the currency
            used on the associated payment.


            Min value: `0`
        reason:
          $ref: '#/components/schemas/disputes_DisputeReason'
          description: >-
            4-digit code consisting of 2 letters followed by 2 numbers that
            indicates why the dispute was created, at a high level.


            Current values:


            - `FR10`: Customer has no knowledge of the payment.

            - `FR11`: Customer has no knowledge of the payment and liability has
            shifted to the merchant due to collusion, fraud monitoring program
            thresholds, or any other reason.

            - `PE10`: Payment was processed twice.

            - `PE11`: Payment amount differs from agreed amount.

            - `PE12`: Payment was paid for by another means.

            - `CD10`: Cancelled services.

            - `CD11`: Goods or services differ from what was agreed upon for the
            payment.

            - `CD12`: The goods or services were not received.

            - `CD13`: The purchase was cancelled or returned, but the refund has
            not been processed.
        settlement_withholding:
          $ref: '#/components/schemas/disputes_DisputeSettlementWithholding'
          description: >-
            Indicates if the disputed amount has already been withheld from a
            settlement or not.


            Current values:


            - `NOT_WITHHELD`: The disputed amount has not yet been withheld in a
            settlement. It may impact future settlements if the dispute is
            "lost" by the merchant.


            - `WITHHELD_ALREADY`: The disputed amount was withheld in a prior
            settlement. This dispute will not impact future settlements.
        state:
          $ref: '#/components/schemas/disputes_DisputeState'
          description: |-
            The step in the dispute lifecycle that this dispute is currently at:

            - `RESPONSE_REQUIRED`
            - `NO_RESPONSE_REQUIRED`
            - `PROCESSING`
            - `ACCEPTED`
            - `WON`
            - `PARTIALLY_WON`
            - `LOST`
        created_at:
          type: string
          format: date-time
          description: >-
            When this dispute was created, in [RFC
            3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC).
        response_due_at:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            When the dispute must be challenged by, after which it will be
            automatically accepted, in [RFC
            3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC).
        updated_at:
          type: string
          format: date-time
          description: >-
            When this dispute was last updated, in [RFC
            3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC).
        merchant_id:
          type: string
          minLength: 1
          maxLength: 128
          description: |-
            ID of the merchant that collected the disputed payment.

            Min length: `1`
            Max length: `128`
      required:
        - id
        - payment_id
        - amount
        - reason
        - settlement_withholding
        - state
        - created_at
        - updated_at
        - merchant_id
      description: >-
        Represents a dispute initiated by a customer within Cash App or the
        customer's linked bank
      title: Dispute
    disputes_AcceptDisputeResponse:
      type: object
      properties:
        dispute:
          $ref: '#/components/schemas/disputes_Dispute'
      title: AcceptDisputeResponse
    ErrorCategory:
      type: string
      enum:
        - API_ERROR
        - AUTHENTICATION_ERROR
        - BRAND_ERROR
        - DISPUTE_ERROR
        - MERCHANT_ERROR
        - INVALID_REQUEST_ERROR
        - PAYMENT_PROCESSING_ERROR
        - RATE_LIMIT_ERROR
        - WEBHOOK_ERROR
        - API_KEY_ERROR
        - GRANT_ERROR
      description: The high-level reason the error occurred.
      title: ErrorCategory
    Error:
      type: object
      properties:
        category:
          $ref: '#/components/schemas/ErrorCategory'
          description: The high-level reason the error occurred.
        code:
          type: string
          description: >-
            A unique identifier for the specific type of error that occurred.
            For more information, see [Error Code
            Reference](/cash-app-pay-partner-api/guides/technical-guides/api-fundamentals/errors/error-code-reference).


            Min length: `1`
        detail:
          type: string
          description: >-
            Human-readable description of why the error occurred and how to
            resolve it.


            Min length: `1`
        field:
          type: string
          description: >-
            The field in the request that caused the error, using array and
            object dot notation.


            Min length: `1`
      required:
        - category
        - code
      description: Represents an error encountered during a request to the API.
      title: Error
    ErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/Error'
          description: |-
            A list of errors that occurred while processing the request.

            Min number of items: `1`
      required:
        - errors
      title: ErrorResponse

```

**`Example`**

```json Example
{
  "id": "DSPT_1fbjn9dg7rmz1xeyv6gkyh8vg",
  "payment_id": "PWC_4nn21zy6t0v2yhqg5bvhk7xkq",
  "amount": 1500,
  "customer_credited_amount": 1250,
  "reason": "FR10",
  "settlement_withholding": "NOT_WITHHELD",
  "state": "RESPONSE_REQUIRED",
  "created_at": "2022-01-01T12:00:00Z",
  "response_due_at": "2022-05-01T00:00:00Z",
  "updated_at": "2022-01-05T12:00:00Z",
  "merchant_id": "MMI_4vxs5egfk7hmta3qx2h6rp91x"
}
```