Skip to main content
WEBHOOK
TRANSACTION_FEE
{
  "event":       "TRANSACTION_FEE",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "transactionId":        "txn_01HXYZ4444ABCDEF9999",
    "cardId":               "crd_01HXYZ5555ABCDEF1111",
    "programId":            "prg_01HXYZ9876ABCDEF0000",
    "cardholderId":         "chl_01HXYZ1234ABCDEF5678",
    "externalId":           "my-user-id-789",
    "type":                 "FEE",
    "status":               "SETTLED",
    "amountCents":          150,
    "currency":             "USD",
    "billingAmountCents":   150,
    "billingCurrency":      "USD",
    "exchangeRate":         null,
    "feeType":              "CROSS_BORDER",
    "relatedTransactionId": "txn_01HXYZ8888ABCDEF9999"
  }
}

{}

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.

Fires when a fee is automatically applied to a card. Fee transactions reduce the card’s balance by the fee amount. The merchant object is absent for fee transactions.

​
Event Type

TRANSACTION_FEE

​
Payload

{
  "event":       "TRANSACTION_FEE",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "transactionId":        "txn_01HXYZ4444ABCDEF9999",
    "cardId":               "crd_01HXYZ5555ABCDEF1111",
    "programId":            "prg_01HXYZ9876ABCDEF0000",
    "cardholderId":         "chl_01HXYZ1234ABCDEF5678",
    "externalId":           "my-user-id-789",
    "type":                 "FEE",
    "status":               "SETTLED",
    "amountCents":          150,
    "currency":             "USD",
    "billingAmountCents":   150,
    "billingCurrency":      "USD",
    "exchangeRate":         null,
    "feeType":              "CROSS_BORDER",
    "relatedTransactionId": "txn_01HXYZ8888ABCDEF9999"
  }
}

​
Payload Fields

FieldTypeDescription
transactionIdstringUnique transaction ID for this fee event
typestringAlways FEE for this event
statusstringAlways SETTLED for this event
amountCentsintegerFee amount in cents
feeTypestringFee type: CROSS_BORDER, DECLINE, MAINTENANCE, ATM_WITHDRAWAL, OTHER
relatedTransactionIdstring or nullThe transaction that triggered this fee, if applicable
All other fields are the same as TRANSACTION_AUTHORIZED. See Transaction Events for the full field reference. 
{
  "event":       "TRANSACTION_FEE",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "transactionId":        "txn_01HXYZ4444ABCDEF9999",
    "cardId":               "crd_01HXYZ5555ABCDEF1111",
    "programId":            "prg_01HXYZ9876ABCDEF0000",
    "cardholderId":         "chl_01HXYZ1234ABCDEF5678",
    "externalId":           "my-user-id-789",
    "type":                 "FEE",
    "status":               "SETTLED",
    "amountCents":          150,
    "currency":             "USD",
    "billingAmountCents":   150,
    "billingCurrency":      "USD",
    "exchangeRate":         null,
    "feeType":              "CROSS_BORDER",
    "relatedTransactionId": "txn_01HXYZ8888ABCDEF9999"
  }
}

{}

Authorizations

​
Authorization
string
header
required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Body

application/json
​
event
string
Example:

"TRANSACTION_FEE"

​
eventId
string
​
businessId
string
​
environment
enum<string>
Available options:
LIVE,
SANDBOX
​
timestamp
string<date-time>
​
data
object

Response

200

Acknowledge the event.