# Card transaction event object

The card transaction event object represents a specific event within the lifecycle of a card transaction (e.g., authorization, clear, refund).

### Object Parameters

- `amounts` `object` — The amounts associated with the event
  - `cardholder_authorized` `object` — The amount authorized and being held in the cardholder's currency
    - `amount` `number` — The amount in the smallest unit of the currency
    - `currency_code` `string` — The currency code (e.g., `USD`)
    - `fx_rate` `string` — The foreign exchange rate (if applicable), serialized as a decimal string
  - `cardholder_requested` `object` — The amount requested by the merchant in the cardholder's currency
    - `amount` `number` — The amount in the smallest unit of the currency
    - `currency_code` `string` — The currency code (e.g., `USD`)
    - `fx_rate` `string` — The foreign exchange rate (if applicable), serialized as a decimal string
  - `cardholder_settled` `object` — The amount settled in the cardholder's currency
    - `amount` `number` — The amount in the smallest unit of the currency
    - `currency_code` `string` — The currency code (e.g., `USD`)
    - `fx_rate` `string` — The foreign exchange rate (if applicable), serialized as a decimal string
  - `merchant_authorized` `object` — The amount authorized and being held in the merchant's currency
    - `amount` `number` — The amount in the smallest unit of the currency
    - `currency_code` `string` — The currency code (e.g., `USD`)
    - `fx_rate` `string` — The foreign exchange rate (if applicable), serialized as a decimal string
  - `merchant_requested` `object` — The amount requested by the merchant in the merchant's currency
    - `amount` `number` — The amount in the smallest unit of the currency
    - `currency_code` `string` — The currency code (e.g., `USD`)
    - `fx_rate` `string` — The foreign exchange rate (if applicable), serialized as a decimal string
  - `merchant_settled` `object` — The amount settled in the merchant's currency
    - `amount` `number` — The amount in the smallest unit of the currency
    - `currency_code` `string` — The currency code (e.g., `USD`)
    - `fx_rate` `string` — The foreign exchange rate (if applicable), serialized as a decimal string
- `authentication_attempt_id` `string` — The authentication attempt ID
- `authorization_expires_at` `date-time` — The authorization expiration date
- `card_account_id` `string` — The ID of the card account
- `card_id` `string` — The ID of the card
- `card_program_id` `string` — The ID of the card program
- `card_token_id` `string` — The card token used for this transaction event, if applicable.
- `created_at` `date-time` — The creation date of the card transaction event
- `decisioning_details` `object` — Authorization decisioning details
  - `auth_code` `string` — The authorization code
  - `card_authorization_policy_decision` `enum` — The aggregate authorization policy decision. Possible values: `passed`, `failed`, `skipped`
  - `card_authorization_policy_decision_reason` `string` — The reason the aggregate authorization policy decision was made. Only set when the policy decision is failed
  - `card_authorization_policy_evaluations` `array of objects` — Per-policy evaluation results showing the outcome of each authorization policy
    - `card_authorization_policy_id` `string` — The ID of the card authorization policy
    - `card_authorization_policy_version_id` `string` — The ID of the card authorization policy version
    - `decision` `enum` — The policy evaluation decision. Possible values: `passed`, `failed`, `skipped`
    - `decision_reason` `string` — The reason the policy failed. Only set when decision is failed
    - `owner` `enum` — The owner of the policy. Possible values: `column`, `platform_owner`
    - `scope` `enum` — The scope of the policy. Possible values: `card_program`, `card_account`, `card`
  - `decision` `enum` — The authorization decision. Possible values: `undecided`, `approved`, `partially_approved`, `declined`
  - `decision_reason` `enum` — The reason the decision was made
    Possible values: `approved`, `partially_approved`, `insufficient_funds`, `suspected_fraud`, `realtime_authorization_request_timeout`, `realtime_authorization_connection_error`, `realtime_authorization_invalid_response`, `manual_override`, `generic_decline`, `error`, `realtime_authorization_endpoint_missing`, `invalid_transaction`, `account_closed`, `account_blocked`, `card_lost`, `card_stolen`, `card_expired`, `invalid_merchant`, `exceeds_approval_amount_limit`, `invalid_verification_code`, `invalid_cvv`, `invalid_cvv2`, `missing_or_invalid_pin`, `account_verification_succeeded`, `account_verification_and_anticipated_amount_succeeded`, `account_verification_succeeded_unsupported_amount`, `stop_payment`, `invalid_account_type_savings`, `invalid_account_type_checking`, `invalid_account_type_credit`, `three_ds_authentication_required`, `invalid_expiration`, `compliance_decline`, `card_paused`, `pin_cryptographic_error`, `invalid_amount`, `pending`
  - `decision_source` `enum` — The party that made the authorization decision. Possible values: `card_network`, `column`, `platform_owner`
  - `realtime_authorization_amount` `number` — The amount returned by the platform's realtime authorization endpoint, in the smallest unit of the currency
  - `realtime_authorization_decision` `string` — The decision returned by the platform's realtime authorization endpoint. Possible values: `approve`, `partially_approve`, `decline`
  - `realtime_authorization_decision_reason` `string` — The decline reason returned by the platform's realtime authorization endpoint
- `event_type` `enum` — The type of the card transaction event. Possible values: `financial`, `financial_reversal`, `authorization`, `authorization_reversal`, `authorization_expiration`, `authorization_completion`, `incremental_authorization`, `incremental_authorization_reversal`, `reauthorization`, `reauthorization_reversal`, `refund_authorization`, `refund_authorization_reversal`, `refund_financial`, `refund_financial_reversal`, `clear`, `clear_reversal`, `credit_clear`, `credit_clear_reversal`, `credit_applied`, `force_clear`, `force_clear_reversal`, `account_verification`, `original_credit`, `original_credit_reversal`, `balance_inquiry`, `dispute_credit`, `dispute_credit_reversal`, `dispute_debit`, `dispute_debit_reversal`, `credit_applied_reversal`
- `id` `string` — The ID of the card transaction event

**Response 200**

```json
{
  "amounts": {
    "cardholder_authorized": {
      "amount": 12345,
      "currency_code": "USD",
      "fx_rate": "1.0842"
    },
    "cardholder_requested": {
      "amount": 12345,
      "currency_code": "USD",
      "fx_rate": "1.0842"
    },
    "cardholder_settled": {
      "amount": 12345,
      "currency_code": "USD",
      "fx_rate": "1.0842"
    },
    "merchant_authorized": {
      "amount": 12345,
      "currency_code": "USD",
      "fx_rate": "1.0842"
    },
    "merchant_requested": {
      "amount": 12345,
      "currency_code": "USD",
      "fx_rate": "1.0842"
    },
    "merchant_settled": {
      "amount": 12345,
      "currency_code": "USD",
      "fx_rate": "1.0842"
    }
  },
  "authentication_attempt_id": "caat_2x8gszy5folpA9s0TOCseE9ABDM",
  "authorization_expires_at": "2024-01-15T09:30:00Z",
  "card_account_id": "cacc_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_id": "card_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_program_id": "cpgm_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_token_id": "ctkn_2x8gszy5folpA9s0TOCseE9ABDM",
  "created_at": "2024-01-15T09:30:00Z",
  "decisioning_details": {
    "auth_code": "A12345",
    "card_authorization_policy_decision": "passed",
    "card_authorization_policy_decision_reason": null,
    "card_authorization_policy_evaluations": [
      {
        "card_authorization_policy_id": "caup_2x8gszy5folpA9s0TOCseE9ABDM",
        "card_authorization_policy_version_id": "cauv_2x8gszy5folpA9s0TOCseE9ABDM",
        "decision": "passed",
        "decision_reason": null,
        "owner": "column",
        "scope": "card_program"
      }
    ],
    "decision": "undecided",
    "decision_reason": "approved",
    "decision_source": "card_network",
    "realtime_authorization_amount": 10000,
    "realtime_authorization_decision": "approve",
    "realtime_authorization_decision_reason": null
  },
  "event_type": "financial",
  "id": "ctxe_2x8gszy5folpA9s0TOCseE9ABDM"
}
```