---
title: "Report that a chargeback occurred"
method: POST
path: "/enrichments/{enrichmentId}/chargeback"
tags: ["Feedback and Reporting"]
---

# Report that a chargeback occurred

`POST /enrichments/{enrichmentId}/chargeback`

An endpoint for reporting that a chargeback process has occurred on a transaction. The `state` and `chargebackNotes` properties can be used to provide information about the chargeback. The `isFraud`, `fraudType`, and `fraudNotes` are used to provide information about fraud or suspected fraud related to this chargeback. Note that this transaction must previously have been enriched to report the chargeback.

## Request body

- object
  - `state` 'chargeback_won' | 'chargeback_lost' | 'chargeback_pending', required — The state of the chargeback process. You can update a chargeback's `state` by submitting another request with a new `state`, for example, a new request could update the `state` from `chargeback_pending` to `chargeback_won`.
  - `chargebackNotes` string — Any additional details related to the chargeback not covered by the state.
  - `occurredAt` string, date-time — The time when the chargeback's state change. This could be the time when the chargeback was initiated and its state became `chargeback_pending` or the time when the chargeback was resolved its state moved to `chargeback_won` or `chargeback_lost`. Formatted as an ISO 8601 date time.
  - `isFraud` boolean — A boolean indicating if this transaction was suspected to involve fraud.
  - `fraudType` 'card_not_present' | 'card_testing' | 'chargeback_fraud' | 'counterfeit_card' | 'merchant_fraud' | 'other' | 'phishing' | 'stolen_card' | 'unknown' | 'none' — The type of fraud suspected to have occurred. This field can only be provided if `isFraud` is true.
  - `fraudNotes` string — Any additional details related to fraud suspected to have occurred on the associated transaction. This field can only be provided if `isFraud` is true.

## Response `200`

Chargeback reported successfully.

- EnrichmentFeedbackResponse — Response for reporting any kind of enrichment feedback.
  - `details` string

## Other responses

- `400` — Invalid input
- `403` — Unauthorized
- `500` — Unexpected Error

---

[API](https://skmtc.net/spade/apis/spade-api.md) · [All operations](https://skmtc.net/spade/apis/spade-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spade/spade-api/revisions/a37c626f84de/schema)