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",
    "cardholderId":    "chl_01HXYZ1234ABCDEF5678",
    "externalId":      "my-user-id-789",
    "type":            "FEE",
    "status":          "APPROVED",
    "amount":          1.50,
    "currency":        "USD",
    "billingAmount":   1.50,
    "billingCurrency": "USD",
    "feeLabel":        "CROSS_BORDER",
    "authorizationCode":    "A1B2C3",
    "relatedTransactionId": "A1B2C3"
  }
}

{}

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",
    "cardholderId":    "chl_01HXYZ1234ABCDEF5678",
    "externalId":      "my-user-id-789",
    "type":            "FEE",
    "status":          "APPROVED",
    "amount":          1.50,
    "currency":        "USD",
    "billingAmount":   1.50,
    "billingCurrency": "USD",
    "feeLabel":        "CROSS_BORDER",
    "authorizationCode":    "A1B2C3",
    "relatedTransactionId": "A1B2C3"
  }
}

{}

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",
    "cardholderId":    "chl_01HXYZ1234ABCDEF5678",
    "externalId":      "my-user-id-789",
    "type":            "FEE",
    "status":          "APPROVED",
    "amount":          1.50,
    "currency":        "USD",
    "billingAmount":   1.50,
    "billingCurrency": "USD",
    "feeLabel":        "CROSS_BORDER",
    "authorizationCode":    "A1B2C3",
    "relatedTransactionId": "A1B2C3"
  }
}

Payload Fields

Field	Type	Description
`transactionId`	string	Unique transaction ID for this fee event
`type`	string	Always `FEE` for this event
`status`	string	Always `APPROVED` for this event
`amount`	number	Fee amount in dollars
`feeLabel`	string	Fee label from the card provider — e.g. `CROSS_BORDER`, `DECLINE`, `MAINTENANCE`
`authorizationCode`	string	Network authorization code of the underlying transaction this fee was charged for — the same field carried by `TRANSACTION_AUTHORIZED`/`TRANSACTION_CLEARED`/`TRANSACTION_DECLINED`. Present when the card network supplies one
`relatedTransactionId`	string	Points back to the originating purchase or decline this fee relates to. Equals `authorizationCode`. Use it to link a fee to the transaction that triggered it

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",
    "cardholderId":    "chl_01HXYZ1234ABCDEF5678",
    "externalId":      "my-user-id-789",
    "type":            "FEE",
    "status":          "APPROVED",
    "amount":          1.50,
    "currency":        "USD",
    "billingAmount":   1.50,
    "billingCurrency": "USD",
    "feeLabel":        "CROSS_BORDER",
    "authorizationCode":    "A1B2C3",
    "relatedTransactionId": "A1B2C3"
  }
}

{}

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

Show child attributes

Response

200

Acknowledge the event.

Guides

JIT Authorization

Card Events

Transaction Events

Cardholder Events

Account Events

Billing Events

Event Type

Payload

Payload Fields

Authorizations

Body

Response

​Event Type

​Payload

​Payload Fields

Authorizations

Body

Response

Event Type

Payload

Payload Fields