Card Transaction Decline Fee (Domestic)

{
  "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"
  }
}

{}

{
  "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"
  }
}

{}

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

Card Transaction Cross-border Fee Card Transaction Decline Fee (International)

​Payload Fields

Payload Fields