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

# Report that a card decline occurred

`POST /enrichments/{enrichmentId}/decline`

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

## Request body

- object
  - `declineCode` string — A two digit alphanumeric code indicating why a card transaction was declined. For reference, see the [Visa Action Code](https://developer.visa.com/request_response_codes) or the [Mastercard Network Response Codes](https://developer.mastercard.com/mastercard-merchant-presented-qr/documentation/server-apis/response-error-codes/#network-response-codes).
  - `declineDescription` string — A plain text description associated with a decline code.
  - `declineNotes` string — Any additional details related to a card decline not covered by the `declineCode` or `declineDescription`.
  - `occurredAt` string, date-time — The time the decline occurred. 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`

Decline 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)