---
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`

## Request

- Base URL: `https://east.sandbox.spade.com`
- URL: `https://east.sandbox.spade.com/enrichments/{enrichmentId}/decline`
- Auth: API key in header `X-Api-Key`

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.dev/spade/apis/spade-api.md) - [All operations](https://skmtc.dev/spade/apis/spade-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spade/apis/spade-api/revisions/a37c626f84de?raw)