> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Card Transaction Decline Fee (Domestic)

> Sent when a domestic decline fee is charged after a card transaction is declined at a domestic merchant.

<RequestExample>
  ```json Webhook Payload theme={null}
  {
    "event": "card.transaction.decline_fee_domestic",
    "version": "3.0",
    "eventId": "g4b5c6d7-e8f9-0123-6789-bcdef0123456",
    "sign": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "data": {
      "cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
      "cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
      "reference": "hos_fee_a4e8f2b6_20260510143400",
      "originalReference": "hos_dc_a4e8f2b6_20260510143201",
      "type": "DEBIT",
      "amount": 0.40,
      "currency": "USD",
      "merchant": {
        "name": "GOOGLE Lightroom",
        "country": "US",
        "mcc": "5816"
      },
      "category": "Decline Fee (Domestic)",
      "network": "VISA",
      "authorizationCode": null,
      "status": "APPROVED",
      "appId": "A1B2C3D4E5F6G7H8",
      "timestamp": "2026-05-10T14:34:00Z"
    }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {}
  ```
</ResponseExample>

## Payload Fields

| Field               | Type           | Description                                                   |
| ------------------- | -------------- | ------------------------------------------------------------- |
| `cardId`            | string         | Your card identifier                                          |
| `cardholderId`      | string         | Cardholder identifier                                         |
| `reference`         | string \| null | Unique fee transaction reference                              |
| `originalReference` | string \| null | Reference of the declined transaction that triggered this fee |
| `type`              | string         | Always `"DEBIT"`                                              |
| `amount`            | number         | Fee amount charged                                            |
| `currency`          | string         | Currency code (e.g., `"USD"`)                                 |
| `merchant.name`     | string         | Merchant name from the declined transaction                   |
| `merchant.country`  | string \| null | Merchant country code                                         |
| `merchant.mcc`      | string \| null | Merchant category code                                        |
| `category`          | string         | Always `"Decline Fee (Domestic)"`                             |
| `network`           | string \| null | Card network (e.g., `"VISA"`, `"MASTERCARD"`)                 |
| `authorizationCode` | string \| null | Authorization code if available                               |
| `status`            | string         | Always `"APPROVED"`                                           |