Skip to main content

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.

{
  "event": "card.transaction.cross_border_fee",
  "version": "3.0",
  "eventId": "f3a4b5c6-d7e8-9012-5678-abcdef012345",
  "sign": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
  "data": {
    "cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
    "cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
    "reference": "hos_fee_a4e8f2b6_20260510143300",
    "originalReference": "hos_tx_a4e8f2b6_20260510143200",
    "type": "DEBIT",
    "amount": 0.50,
    "currency": "USD",
    "merchant": {
      "name": "Gulf Health Counsel Riyadh",
      "country": "SA",
      "mcc": "9399"
    },
    "category": "Cross-border Fee",
    "network": null,
    "authorizationCode": "955834",
    "status": "APPROVED",
    "appId": "A1B2C3D4E5F6G7H8",
    "timestamp": "2026-05-10T14:33:00Z"
  }
}

{}

​
Payload Fields

FieldTypeDescription
cardIdstringYour card identifier
cardholderIdstringCardholder identifier
referencestring | nullUnique fee transaction reference
originalReferencestring | nullReference of the original charge that triggered this fee
typestringAlways "DEBIT"
amountnumberFee amount charged
currencystringCurrency code (e.g., "USD")
merchant.namestringMerchant name from the original charge
merchant.countrystring | nullMerchant country code
merchant.mccstring | nullMerchant category code
categorystringAlways "Cross-border Fee"
networkstring | nullCard network
authorizationCodestring | nullAuthorization code from the original charge
statusstringAlways "APPROVED"