---
title: "Close dispute"
method: POST
path: "/disputes/{dispute_id}/close"
tags: ["Disputes API"]
---

# Close dispute

`POST /disputes/{dispute_id}/close`

## Path parameters

- `dispute_id` string, required

## Headers

- `Idempotency-Key` string

## Response `200`

Success

- UpdateDisputeResponse
  - `dispute` Dispute
    - `id` string — ID of dispute
    - `transaction_id` string — ID of associated charge with the dispute
    - `order_id` string — Merchant reference for associated order with the dispute
    - `open` boolean — Indicates if dispute is open or not.
    - `transaction_amount` integer — Total amount in cents of transaction which is being disputed
    - `dispute_amount` integer — Dispute amount in the smallest denomination of the currency, such as cents
    - `currency` string — The local currency of the dispute, must be a valid subset of the ISO 4217 currency code
    - `dispute_reason` 'cancellation_or_return_not_processed' | 'incorrect_amount' | 'product_not_received' | 'product_unacceptable' | 'cancellation_not_processed' | 'return_not_processed' — Dispute reason
    - `status` 'action_required_merchant' | 'no_merchant_action_needed' | 'closed_customer_favor' | 'closed_merchant_favor' | 'closed_customer_partial_favor' — Current dispute status
    - `response_due_by` string, date-time — Deadline by which merchant must respond to the dispute, in ISO 8601 UTC format
    - `created` string, date-time — Timestamp indicating when the dispute was opened, in ISO 8601 UTC format
    - `updated` string, date-time — Timestamp indicating when the dispute was last updated, in ISO 8601 UTC format
    - `comments` string[] — Text blob from the customer describing the complaint reason for the dispute
    - `attached_files` object[] — Array of attached files to dispute
      - `file_name` string — name of file
      - `file_url` string — presigned_url for file that expires after 60 minutes
    - `closed_at` string, date-time — Timestamp indicating when the dispute was closed, in ISO 8601 UTC format
    - `evidence_received_at` string, date-time — Timestamp indicating when evidence was received for this dispute, in ISO 8601 UTC format
    - `extra_evidence` ExtraEvidence[]
      - `shipping_info` object
        - `company_name` string — Carrier company for shipment of order
        - `tracking_number` string — Carrier company tracking number for shipment of order
      - `communication_info` object
        - `contact_type` 'already_contacted' | 'no_contact' | 'no_response' — Type of contact between customer and merchant prior to dispute opening
        - `merchant_contact_name` string — Name of merchant contact that customer interacted with before opening the dispute
        - `first_contact_date` string, date — First time customer contacted merchant, as YYYY-MM-DD
        - `last_contact_date` string, date — Last time customer contacted merchant, as YYYY-MM-DD
      - `return_info` object
        - `type` 'all' | 'partial' | 'none' | 'not_accepted' — Type of return
        - `return_date` string, date — Date of return, as YYYY-MM-DD
        - `method` 'mail' | 'in_store' — Method of return
        - `shipping_delivery` string, date — Date of shipment delivery as YYYY-MM-DD
      - `cancellation_info` object
        - `cancellation_status` 'Customer_cancelled_entire_order' | 'Customer_cancelled_part_of_order' | 'Merchant_cancelled_entire_order' | 'Merchant_cancelled_part_of_order' | 'Attempted_cancellation_not_accepted' | 'Not_cancelled'
        - `cancellation_date` string, date — Date of cancellation, as YYYY-MM-DD
        - `cancellation_method` 'Cancelled_online' | 'Cancelled_in_store'
        - `company_name` string — Carrier company for shipment of return
        - `tracking_number` string — Carrier company tracking number for shipment of order
        - `shipping_delivery` string, date — Date of shipment delivery, as YYYY-MM-DD
        - `store_address` string — Store address for cancelled order
    - `transition_logs` object[] — A list of all dispute events corresponding to the dispute
      - `type` 'created' | 'customer_evidence_added' | 'merchant_evidence_added' | 'merchant_more_evidence_required' | 'adjudicated_customer_fault' | 'adjudicated_merchant_fault' — Type of the dispute state transition denoted by the dispute event
      - `created` string, date-time — Timestamp indicating when the dispute event was opened, in ISO 8601 UTC format

## Other responses

- `400` — Invalid Input
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/affirm/apis/merchant-transaction-api.md) · [All operations](https://skmtc.net/affirm/apis/merchant-transaction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affirm/merchant-transaction-api/versions/f2f4252c946f/schema)