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