---
title: "Update chargeback evidence"
method: PATCH
path: "/chargebacks/{chargebackId}/evidence"
tags: ["Chargebacks"]
---

# Update chargeback evidence

`PATCH /chargebacks/{chargebackId}/evidence`

Save evidence changes without submitting the response

## Path parameters

- `chargebackId` string, required

## Headers

- `Idempotency-Key` string, required
- `X-Instance-ID` string, nullable

## Request body

- object
  - `customerPartyId` string — Connected customer to act on behalf of.
  - `data` object, required
    - `attributes` object, required
      - `responseReason` 'cardholderWithdrew' | 'authorizedPurchase' | 'alreadyRefunded' | 'receivedProduct' | 'other', nullable — Why you are contesting the chargeback.
      - `productType` 'physical' | 'digital' | 'inPersonService' | 'other', nullable — Type of goods or services sold.
      - `shippedOn` string, date, nullable — Date the goods were shipped. Applies when productType is physical. Natural clears it for other product types.
      - `serviceDate` string, date, nullable — Date the service was provided. Applies when productType is inPersonService. Natural clears it for other product types.
      - `productDescription` string, nullable — Description of the goods or services sold. Recorded sale details satisfy this requirement when omitted.
      - `explanation` string, nullable — Explanation of why the chargeback should be reversed.
      - `deliveryDetails` string, nullable — How the goods or services were delivered.
      - `usageDetails` string, nullable — How the cardholder received or used the purchase, such as access or download records.
      - `shippingAddress` string, nullable — Address the goods were shipped to, as one line. Applies when productType is physical. Natural clears it for other product types.
      - `shippingCarrier` string, nullable — Shipping carrier. Applies when productType is physical. Natural clears it for other product types.
      - `trackingNumber` string, nullable — Carrier tracking number. Applies when productType is physical. Natural clears it for other product types.
      - `cardholderName` string, nullable — Cardholder name supplied to support the response.
      - `cardholderEmail` string, nullable — Cardholder email supplied to support the response.
      - `cardholderPhone` string, nullable — Cardholder phone supplied to support the response.
      - `billingAddress` string, nullable — Full billing address supplied as evidence. This does not change recorded billing facts.
      - `refundPolicyDisclosure` string, nullable — How and when the refund policy was disclosed.
      - `refundDetails` string, nullable — Additional explanation of a refund. Natural includes its recorded refund facts.
      - `attachments` object[] — Replaces the attached files and their order.
        - `fileId` string, required — ID of a validated file uploaded for this chargeback.
        - `purposes` string[], required — Evidence categories supported by this file.
        - `note` string, nullable, required — Explanation of what this file demonstrates.
      - `version` integer, required — Version of the case. Send it when updating or submitting evidence.

## Response `200`

Successful Response

- object
  - `data` object, required
    - `id` string, required — The chargeback ID. Evidence has no ID of its own.
    - `type` 'chargebackEvidence', required
    - `attributes` object, required
      - `version` integer, required — Version of the case. Send it when updating or submitting evidence.
      - `responseReason` 'cardholderWithdrew' | 'authorizedPurchase' | 'alreadyRefunded' | 'receivedProduct' | 'other', nullable, required — Why you are contesting the chargeback.
      - `productType` 'physical' | 'digital' | 'inPersonService' | 'other', nullable, required — Type of goods or services sold.
      - `shippedOn` string, date, nullable, required — Date the goods were shipped. Applies when productType is physical. Natural clears it for other product types.
      - `serviceDate` string, date, nullable, required — Date the service was provided. Applies when productType is inPersonService. Natural clears it for other product types.
      - `productDescription` string, nullable, required — Description of the goods or services sold. Recorded sale details satisfy this requirement when omitted.
      - `explanation` string, nullable, required — Explanation of why the chargeback should be reversed.
      - `deliveryDetails` string, nullable, required — How the goods or services were delivered.
      - `usageDetails` string, nullable, required — How the cardholder received or used the purchase, such as access or download records.
      - `shippingAddress` string, nullable, required — Address the goods were shipped to, as one line. Applies when productType is physical. Natural clears it for other product types.
      - `shippingCarrier` string, nullable, required — Shipping carrier. Applies when productType is physical. Natural clears it for other product types.
      - `trackingNumber` string, nullable, required — Carrier tracking number. Applies when productType is physical. Natural clears it for other product types.
      - `cardholderName` string, nullable, required — Cardholder name supplied to support the response.
      - `cardholderEmail` string, nullable, required — Cardholder email supplied to support the response.
      - `cardholderPhone` string, nullable, required — Cardholder phone supplied to support the response.
      - `billingAddress` string, nullable, required — Full billing address supplied as evidence. This does not change recorded billing facts.
      - `refundPolicyDisclosure` string, nullable, required — How and when the refund policy was disclosed.
      - `refundDetails` string, nullable, required — Additional explanation of a refund. Natural includes its recorded refund facts.
      - `attachments` object[], required — Files attached to the response, in packet order.
        - `fileId` string, required — ID of a validated file uploaded for this chargeback.
        - `purposes` string[], required — Evidence categories supported by this file.
        - `note` string, nullable, required
        - `file` object, required
          - `filename` string, nullable, required — Sanitized filename. Null for files uploaded before filename capture was available.
          - `contentType` 'application/pdf' | 'image/jpeg' | 'image/png', required
          - `sizeBytes` integer, nullable, required — Original uploaded bytes. Null for historical files whose original size was not recorded.
          - `pageCount` integer, required — Number of pages this file contributes to the evidence packet.
          - `createdAt` string, date-time, required — When the file was uploaded and validated.
      - `recommendedPurposes` string[], required — Evidence categories Natural recommends for this reason and response. Empty when the case can no longer be edited.
    - `relationships` object, required
      - `chargeback` object, required
        - `data` object, required — Related resource identifier.
          - `type` 'chargeback', required — Resource type. Always `chargeback`.
          - `id` string, required

## Other responses

- `400` — Validation Error
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found. Returned when the resource does not exist, or when it exists but is not accessible to your account. The two cases are intentionally indistinguishable, so that resource IDs cannot be enumerated by probing.
- `409` — Conflict
- `422` — Validation Error. The response contains one error object for each invalid request value.
- `428` — Precondition Required
- `429` — Too Many Requests
- `500` — Internal Server Error
- `501` — Not Implemented
- `502` — Bad Gateway
- `503` — Service Unavailable

## Changes

- **2026-09-22** `4a05af81217f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/natural/apis/natural-api/changes/chargebacks/:chargebackId/evidence/patch.md)

---

[API](https://skmtc.dev/natural/apis/natural-api.md) · [All operations](https://skmtc.dev/natural/apis/natural-api/llms.txt) · [OpenAPI document](https://skmtc.dev/natural/apis/natural-api/revisions/acc8f2f3d25e?raw)