> ## 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.

# Card Transaction Cross-border Fee

> Sent when a cross-border fee is charged on a card transaction made in a foreign currency or at an international merchant.

<RequestExample>
  ```json Webhook Payload theme={null}
  {
    "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"
    }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {}
  ```
</ResponseExample>

## 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 original charge 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 original charge                   |
| `merchant.country`  | string \| null | Merchant country code                                    |
| `merchant.mcc`      | string \| null | Merchant category code                                   |
| `category`          | string         | Always `"Cross-border Fee"`                              |
| `network`           | string \| null | Card network                                             |
| `authorizationCode` | string \| null | Authorization code from the original charge              |
| `status`            | string         | Always `"APPROVED"`                                      |