{
"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"
}
}
{}
Transaction Events
TRANSACTION_FEE
Fired when a fee is posted against a card — such as a cross-border fee or a decline fee.
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
All other fields are the same as
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 |
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
API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.
Body
application/json
Response
200
Acknowledge the event.