Transactions Object

{
  "token": "<string>",
  "amount": 123,
  "acting_user_token": "<string>",
  "pos": {
    "zip": "<string>",
    "state": "<string>",
    "county": "<string>",
    "pin_present": false,
    "terminal_id": "<string>",
    "country_code": "<string>",
    "is_recurring": false,
    "card_presence": false,
    "is_installment": false,
    "card_holder_presence": false,
    "purchase_amount_only": false,
    "partial_approval_capable": false
  },
  "fees": [
    {
      "amount": 123,
      "currency": "<string>"
    }
  ],
  "flex": {
    "eligible": "<string>",
    "selected_product": "<string>",
    "eligible_products": [
      "<string>"
    ],
    "secondary_credential_identifier": "<string>"
  },
  "user": {
    "metadata": {}
  },
  "fraud": {
    "network": {
      "dii_score": "<string>",
      "account_risk_score": "<string>",
      "dii_score_reason_code": "<string>",
      "transaction_risk_score": 123,
      "account_risk_score_reason_code": "<string>",
      "transaction_risk_score_reason_code": "<string>",
      "card_not_present_transaction_risk_score": "<string>",
      "transaction_risk_score_reason_description": "<string>",
      "transaction_account_attack_intelligence_score": "<string>"
    },
    "issuer_processor": {
      "score": 123,
      "risk_level": "<string>",
      "rule_violations": [
        "<string>"
      ],
      "triggered_rules": [
        {
          "tags": [
            {
              "name": "<string>",
              "value": "<string>"
            }
          ],
          "alert": true,
          "rule_name": "<string>",
          "entity_type": "<string>",
          "suppress_alert": true
        }
      ],
      "riskcontrol_tags": [
        {
          "tag": "<string>",
          "values": [
            "<string>"
          ],
          "rule_name": "<string>"
        }
      ],
      "recommended_action": "<string>",
      "fraud_score_reasons": [
        "<string>"
      ]
    },
    "network_account_intelligence_score": {
      "name": "<string>",
      "value": "<string>",
      "service_type": "<string>"
    }
  },
  "billpay": {
    "amount": "<string>",
    "status": "<string>",
    "user_token": "<string>",
    "biller_token": "<string>",
    "created_time": "<string>",
    "payment_type": "<string>",
    "delivery_date": "<string>",
    "payment_token": "<string>",
    "processing_date": "<string>",
    "last_modified_time": "<string>"
  },
  "dispute": {
    "reason": "<string>",
    "case_management_identifier": "<string>"
  },
  "network": "<string>",
  "accounts": [
    {
      "type": "<string>",
      "token": "<string>",
      "balances": {},
      "description": "<string>",
      "impacted_amount": 123,
      "last_updated_time": "2023-11-07T05:31:56Z",
      "default_currency_code": "<string>"
    }
  ],
  "acquirer": {
    "city": "<string>",
    "name": "<string>",
    "state": "<string>",
    "postal_code": "<string>",
    "country_code": "<string>",
    "street_address": "<string>",
    "institution_country": "<string>",
    "institution_id_code": "<string>",
    "merchant_street_address": "<string>",
    "network_international_id": "<string>",
    "system_trace_audit_number": "<string>",
    "retrieval_reference_number": "<string>"
  },
  "business": {
    "metadata": {}
  },
  "duration": 123,
  "sub_type": "<string>",
  "bin_prefix": "<string>",
  "card_token": "<string>",
  "fleet_data": {
    "items": [
      {
        "unit_price": 123,
        "gross_price": 123,
        "product_code": "<string>",
        "unit_of_measure": "<string>",
        "product_quantity": 123,
        "product_description": "<string>"
      }
    ],
    "prompt_data": {
      "odometer": "<string>",
      "driver_number": "<string>",
      "vehicle_number": "<string>"
    },
    "gross_fuel_price": 123,
    "gross_non_fuel_price": 123
  },
  "identifier": "<string>",
  "standin_by": "<string>",
  "subnetwork": "<string>",
  "to_account": "<string>",
  "user_token": "<string>",
  "batch_number": "<string>",
  "created_time": "2023-11-07T05:31:56Z",
  "from_account": "<string>",
  "account_owner": {
    "dob": "<string>",
    "occupation": "<string>",
    "nationality": "<string>",
    "email_address": "<string>",
    "country_of_birth": "<string>"
  },
  "approval_code": "<string>",
  "card_acceptor": {
    "mcc": "<string>",
    "mid": "<string>",
    "poi": {
      "tid": "<string>",
      "pin_present": "<string>",
      "card_presence": "<string>",
      "cardholder_presence": "<string>",
      "partial_approval_capable": "<string>"
    },
    "url": "<string>",
    "city": "<string>",
    "name": "<string>",
    "phone": "<string>",
    "state": "<string>",
    "address": "<string>",
    "mcc_groups": [
      "<string>"
    ],
    "network_mid": "<string>",
    "postal_code": "<string>",
    "country_code": "<string>",
    "street_address": "<string>",
    "merchant_tax_id": "<string>",
    "sub_merchant_id": "<string>",
    "country_of_origin": "<string>",
    "acceptance_network": {
      "id": "<string>",
      "role": "<string>",
      "seller_id": "<string>"
    },
    "legal_business_name": "<string>",
    "network_assigned_id": "<string>",
    "special_merchant_id": "<string>",
    "customer_service_phone": "<string>",
    "geographic_coordinates": "<string>",
    "payment_facilitator_id": "<string>",
    "business_registration_id": "<string>",
    "payment_facilitator_name": "<string>",
    "merchant_vat_registration_id": "<string>",
    "service_geographic_coordinates": "<string>",
    "transfer_service_provider_name": "<string>",
    "independent_sales_organization_id": "<string>"
  },
  "currency_code": "<string>",
  "issuer_script": {
    "script_type": "<string>",
    "script_status": "<string>"
  },
  "visa_pop_code": "<string>",
  "business_token": "<string>",
  "direct_deposit": {
    "token": "<string>",
    "amount": 123,
    "user_token": "<string>",
    "company_name": "<string>",
    "created_time": "2023-11-07T05:31:56Z",
    "state_reason": "<string>",
    "business_token": "<string>",
    "individual_name": "<string>",
    "settlement_date": "2023-11-07T05:31:56Z",
    "state_reason_code": "<string>",
    "last_modified_time": "2023-11-07T05:31:56Z",
    "company_identification": "<string>",
    "company_entry_description": "<string>",
    "standard_entry_class_code": "<string>",
    "company_discretionary_data": "<string>",
    "direct_deposit_account_token": "<string>",
    "individual_identification_number": "<string>"
  },
  "request_amount": 123,
  "standin_reason": "<string>",
  "account_funding": {
    "sender_city": "<string>",
    "sender_name": "<string>",
    "reference_id": "<string>",
    "sender_state": "<string>",
    "receiver_name": "<string>",
    "sender_address": "<string>",
    "sender_country": "<string>",
    "screening_score": "<string>",
    "entry_device_type": "OFF_THE_SHELF_MOBILE_CONSUMER",
    "sender_postal_code": "<string>",
    "transaction_purpose": "<string>",
    "sender_date_of_birth": "<string>",
    "sender_account_number": "<string>"
  },
  "atc_information": {
    "atc_value": 123,
    "atc_discrepancy_value": 123,
    "atc_discrepancy_indicator": "<string>"
  },
  "original_credit": {
    "sender_city": "<string>",
    "sender_name": "<string>",
    "reference_id": "<string>",
    "sender_state": "<string>",
    "sender_address": "<string>",
    "sender_country": "<string>",
    "screening_score": "<string>",
    "entry_device_type": "OFF_THE_SHELF_MOBILE_CONSUMER",
    "fast_funds_enabled": true,
    "sender_postal_code": "<string>",
    "transaction_purpose": "<string>",
    "sender_date_of_birth": "<string>",
    "sender_account_number": "<string>"
  },
  "settlement_date": "2023-11-07T05:31:56Z",
  "vdcap_qualified": true,
  "cash_back_amount": 123,
  "cashloads_direct": {
    "vendor_product_id": "<string>"
  },
  "installment_data": {
    "installment_plan_identifier": "<string>"
  },
  "network_metadata": {
    "product_id": "<string>",
    "program_id": "<string>",
    "spend_qualifier": "<string>",
    "message_reason_code": "<string>",
    "incoming_response_code": "<string>",
    "outgoing_response_code": "<string>",
    "account_identification_1": "<string>",
    "network_funding_txn_type": "<string>",
    "visa_recurrent_identifier": "<string>",
    "surcharge_free_atm_network": "<string>",
    "visa_recurrent_reference_id": "<string>",
    "terminal_verification_results": "<string>"
  },
  "stop_order_token": "<string>",
  "cardholder_impact": true,
  "is_final_clearing": true,
  "advice_reason_code": "<string>",
  "anticipated_amount": 123,
  "card_product_token": "<string>",
  "from_account_token": "<string>",
  "acquirer_fee_amount": 123,
  "bank_transfer_token": "<string>",
  "currency_conversion": {
    "network": {
      "conversion_rate": 123,
      "original_amount": 123,
      "settlement_data": {
        "amount": 123,
        "currency_code": "<string>",
        "conversion_rate": 123
      },
      "original_currency_code": "<string>",
      "dynamic_currency_conversion": false
    }
  },
  "enhanced_data_token": "<string>",
  "is_offline_approved": "<string>",
  "is_preauthorization": false,
  "issuer_payment_node": "<string>",
  "payment_facilitator": {
    "city": "<string>",
    "state": "<string>",
    "postal_code": "<string>",
    "country_code": "<string>",
    "street_address": "<string>"
  },
  "standin_approved_by": "<string>",
  "address_verification": {
    "on_file": {
      "zip": "<string>",
      "postal_code": "<string>",
      "street_address": "<string>"
    },
    "request": {
      "zip": "<string>",
      "postal_code": "<string>",
      "street_address": "<string>"
    }
  },
  "digital_wallet_token": {
    "state": "<string>",
    "token": "<string>",
    "device": {
      "name": "<string>",
      "type": "<string>",
      "token": "<string>",
      "location": "<string>",
      "device_id": "<string>",
      "ip_address": "<string>",
      "phone_number": "<string>",
      "language_code": "<string>"
    },
    "metadata": {
      "issuer_product_config_id": "<string>",
      "cardproduct_preferred_notification_language": "<string>"
    },
    "card_token": "<string>",
    "created_time": "2023-11-07T05:31:56Z",
    "state_reason": "<string>",
    "otp_verification": {
      "recipient": "<string>",
      "created_time": "2023-11-07T05:31:56Z"
    },
    "fulfillment_status": "<string>",
    "last_modified_time": "2023-11-07T05:31:56Z",
    "transaction_device": {
      "location": "<string>",
      "binding_id": "<string>",
      "ip_address": "<string>",
      "phone_number": "<string>"
    },
    "address_verification": {
      "zip": "<string>",
      "name": "<string>",
      "postal_code": "<string>",
      "street_address": "<string>"
    },
    "wallet_provider_profile": {
      "account": {
        "id": "<string>",
        "score": "<string>",
        "email_address": "<string>"
      },
      "pan_source": "<string>",
      "reason_code": "<string>",
      "device_score": "<string>",
      "risk_assessment": {
        "score": "<string>",
        "version": "<string>"
      },
      "recommendation_reasons": [
        "<string>"
      ]
    },
    "issuer_eligibility_decision": "<string>"
  },
  "issuer_received_time": "<string>",
  "network_reference_id": "<string>",
  "reconciliation_cycle": "<string>",
  "settlement_indicator": "<string>",
  "transaction_metadata": {
    "airline": {
      "depart_date": "2023-11-07T05:31:56Z",
      "passenger_name": "<string>",
      "origination_city": "<string>"
    },
    "transit": {},
    "one_leg_out": true,
    "special_purchase_id": "<string>",
    "is_lodging_auto_rental": false,
    "authorization_life_cycle": 123,
    "cross_border_transaction": false,
    "is_deferred_authorization": true,
    "lodging_auto_rental_start_date": "2023-11-07T05:31:56Z"
  },
  "acquirer_reference_id": "<string>",
  "advice_reason_details": "<string>",
  "amount_to_be_released": 123,
  "preceding_transaction": {
    "token": "<string>",
    "amount": 123
  },
  "user_transaction_time": "2023-11-07T05:31:56Z",
  "local_transaction_date": "2023-11-07T05:31:56Z",
  "transaction_attributes": {},
  "acquirer_reference_data": "<string>",
  "cardholder_verification": {
    "verification_method": "Biometric"
  },
  "estimated_authorization": true,
  "authorization_expiration": "2023-11-07T05:31:56Z",
  "deferred_settlement_days": "<string>",
  "original_settlement_date": "2023-11-07T05:31:56Z",
  "account_name_verification": {
    "on_file": {
      "card_name": "<string>",
      "last_name": "<string>",
      "first_name": "<string>",
      "middle_name": "<string>"
    },
    "request": {
      "card_name": "<string>",
      "last_name": "<string>",
      "first_name": "<string>",
      "middle_name": "<string>"
    }
  },
  "issuer_interchange_amount": 123,
  "velocity_control_balances": {},
  "original_transaction_token": "<string>",
  "interchange_rate_descriptor": "<string>",
  "national_net_cpd_of_original": "<string>",
  "multi_clearing_sequence_count": "<string>",
  "cardholder_authentication_data": {
    "raw_cavv_data": "<string>",
    "issuer_exemption": "<string>",
    "acquirer_exemption": [
      "<string>"
    ],
    "verification_result": "<string>",
    "authentication_method": "<string>",
    "authentication_status": "<string>",
    "three_ds_data_quality": "<string>",
    "three_ds_reference_id": "<string>",
    "three_ds_message_version": "<string>",
    "cavv_authentication_amount": "<string>",
    "electronic_commerce_indicator": "<string>",
    "verification_value_created_by": "<string>"
  },
  "multi_clearing_sequence_number": "<string>",
  "strong_customer_authentication": {
    "issuer_exemption": "LOW_VALUE_PAYMENT"
  },
  "clearing_record_sequence_number": "<string>",
  "network_transaction_lifecycle_id": "<string>",
  "relay_resistance_protocol_result": "<string>",
  "preceding_related_transaction_token": "<string>",
  "merchant_initiated_original_trace_id": "<string>",
  "original_interchange_rate_descriptor": "<string>",
  "digital_commerce_solutions_indicators": {
    "program_type": "<string>",
    "domain_identifier": "<string>",
    "program_type_details": "<string>"
  },
  "digital_commerce_authentication_program": {
    "billing_city": "<string>",
    "phone_number": "<string>",
    "email_address": "<string>",
    "billing_postal_code": "<string>",
    "billing_street_name": "<string>",
    "billing_country_code": "<string>",
    "billing_address_line_1": "<string>",
    "billing_address_line_2": "<string>",
    "billing_building_number": "<string>",
    "billing_subdivision_major": "<string>",
    "billing_subdivision_minor": "<string>"
  },
  "digital_commerce_authentication_indicator": "<string>",
  "original_network_transaction_lifecycle_id": "<string>",
  "incremental_authorization_transaction_tokens": [
    "<string>"
  ],
  "digital_wallet_token_transaction_service_provider_info": {
    "source_token_number": "<string>",
    "cvm_authentication_method": "<string>",
    "digital_service_indicator": "<string>",
    "source_token_requestor_id": "<string>",
    "token_service_provider_id": "<string>",
    "first_authentication_factor": "<string>",
    "cvm_authentication_indicator": "<string>",
    "second_authentication_factor": "<string>",
    "source_token_unique_reference": "<string>",
    "digital_service_provider_type_1": "<string>",
    "digital_service_provider_type_2": "<string>",
    "digital_service_provider_type_3": "<string>",
    "digital_service_provider_type_4": "<string>",
    "digital_service_provider_type_5": "<string>",
    "token_provisioning_insight_data": "<string>",
    "digital_service_provider_identifier_1": "<string>",
    "digital_service_provider_identifier_2": "<string>",
    "digital_service_provider_identifier_3": "<string>",
    "digital_service_provider_identifier_4": "<string>",
    "digital_service_provider_identifier_5": "<string>",
    "source_token_payment_app_or_device_id": "<string>"
  }
}

Transactions are represented by the transaction object. The Marqeta platform creates a separate transaction object for each transaction message received from the card network. The attributes of a given transaction object depend on the transaction type.

This section documents all fields that might be included in a transaction object.

// This schema is used by InfoDev to generate API reference documentation. // File location in GitHub is: openapi/transactions/schemas/transaction_model.yaml

type

enum<string>

required

Transaction event type. For more information about the type field, see <</core-api/event-types#_transaction_events, Transaction events>>.

Available options:

gpa.credit,

gpa.credit.pending,

gpa.credit.pending.reversal,

gpa.credit.reversal,

gpa.credit.networkload,

gpa.credit.networkload.reversal,

gpa.debit.networkload,

gpa.debit,

gpa.debit.pending,

gpa.debit.pending.reversal,

gpa.grant,

gpa.credit.issueroperator,

gpa.debit.issueroperator,

gpa.credit.chargeback,

gpa.credit.chargeback.reversal,

gpa.credit.billpayment,

gpa.credit.authorization.billpayment,

gpa.credit.authorization.billpayment.reversal,

authorization,

authorization.advice,

authorization.reversal,

authorization.clearing,

authorization.reversal.issuerexpiration,

dispute.credit,

dispute.debit,

authorization.clearing.chargeback,

authorization.clearing.chargeback.reversal,

refund,

pindebit.atm.withdrawal,

pindebit.balanceinquiry,

pindebit.cashback,

pindebit.checkavs,

pindebit,

programreserve.credit,

programreserve.debit,

fee.charge.pending,

fee.charge,

fee.charge.refund,

fee.charge.reversal,

fee.charge.waived,

fee.collection.debit,

fee.collection.credit,

funds.expire,

reward.earn,

transfer.peer,

transfer.fee,

account.funding.authorization,

account.funding.authorization.reversal,

account.funding.authorization.clearing,

account.funding.auth_plus_capture,

account.funding.auth_plus_capture.reversal,

account.credit,

account.debit,

balanceinquiry,

authorization.atm.withdrawal,

authorization.pin.change,

authorization.pin.unblock,

authorization.clearing.atm.withdrawal,

authorization.cashback,

authorization.clearing.cashback,

transfer.program,

authorization.quasi.cash,

authorization.clearing.quasi.cash,

authorization.incremental,

gpa.credit.authorization,

gpa.credit.authorization.reversal,

gpa.debit.authorization,

gpa.debit.reversal,

original.credit.authorization,

original.credit.authorization.reversal,

original.credit.authorization.clearing,

original.credit.auth_plus_capture,

original.credit.auth_plus_capture.reversal,

refund.authorization,

refund.authorization.advice,

refund.authorization.clearing,

refund.authorization.reversal,

token.activation-request,

token.advice,

pindebit.authorization,

pindebit.authorization.clearing,

pindebit.authorization.reversal,

pindebit.authorization.reversal.issuerexpiration,

authorization.standin,

authorization.clearing.chargeback.completed,

authorization.clearing.chargeback.provisional.credit,

authorization.clearing.chargeback.provisional.debit,

authorization.clearing.chargeback.writeoff,

directdeposit.credit,

directdeposit.credit.pending,

directdeposit.credit.reject,

directdeposit.credit.pending.reversal,

directdeposit.credit.reversal,

directdeposit.debit,

directdeposit.debit.pending,

directdeposit.debit.reject,

directdeposit.debit.reversal,

pin.change.reversal,

pin.change.reversal.advice,

directdeposit.debit.pending.reversal,

pindebit.chargeback,

pindebit.chargeback.completed,

pindebit.chargeback.provisional.credit,

pindebit.chargeback.provisional.debit,

pindebit.chargeback.reversal,

pindebit.chargeback.writeoff,

pindebit.pin.change,

pindebit.pin.unblock,

pindebit.credit.adjustment,

pindebit.debit.adjustment,

pindebit.quasi.cash,

pindebit.refund,

pindebit.refund.reversal,

pindebit.reversal,

pindebit.transfer,

pin.change.via.api,

product.inquiry,

transit.offer,

transfer.from.checking.hold,

transfer.from.checking.clear,

transfer.to.checking.open,

transfer.to.checking.clear,

transfer.to.savings.open,

transfer.to.savings.clear,

transfer.from.savings.hold,

transfer.from.savings.clear,

fps.debit.hold,

fps.debit.clear,

fps.debit.hold.reverse,

fps.debit.clear.reverse,

fps.credit.open,

fps.credit.clear,

fps.credit.open.reverse,

fps.credit.clear.reverse,

open.banking.fps.debit.hold,

open.banking.fps.debit.clear,

open.banking.fps.debit.hold.reverse,

open.banking.fps.debit.clear.reverse,

interest.posting.clear,

interest.posting.clear.reverse,

interest.posting.adjustment,

chaps.credit.open,

chaps.credit.open.reverse,

chaps.credit.clear,

chaps.credit.clear.reverse,

bacs.credit.open,

bacs.credit.open.reverse,

bacs.credit.clear,

bacs.credit.clear.reverse,

unknown

state

enum<string>

required

Current state of the transaction. For more information about the state field, see <</developer-guides/about-transactions#_the_transaction_lifecycle, The transaction lifecycle>>.

Available options:

PENDING,

CLEARED,

COMPLETION,

DECLINED,

ERROR

token

string

required

read-only

Unique identifier of the transaction, formatted as a UUID.

NOTE: For subsequent related transactions, this token value appears as the preceding_related_transaction_token.

Required string length: 1 - 36

amount

number

required

Amount of the transaction.

acting_user_token

string

required

Unique identifier of the user who conducted the transaction. This might be a child user configured to share its parent's account balance.

Maximum string length: 36

fee

object

Contains details about the fee.

Show child attributes

gpa

object

Returns general purpose account (GPA) balances for a user or business.

Show child attributes

pos

object

Contains information about the point of sale, including details on how the card was presented.

Returned if provided by the card network, and the request uses Transaction Model v2 of the Marqeta Core API. Not returned for Transaction Model v1 requests.

Show child attributes

card

object

Contains information about the card used in the transaction.

Show child attributes

fees

object[]

List of fees associated with the transaction.

This array is returned if it exists in the resource.

Show child attributes

flex

object

Contains information about a Flexible Credential transaction.

Show child attributes

user

object

Contains customer-provided information about the cardholder that performed the transaction.

Show child attributes

fraud

object

Contains one or more fraud determinations by the card network that apply to either the transaction or the cardholder's account.

Show child attributes

store

object

Show child attributes

billpay

object

Show child attributes

dispute

object

Contains information about a disputed transaction.

Show child attributes

network

string

Indicates which card network was used to complete the transactions.

program

object

Information about the program on the Marqeta platform.

Show child attributes

accounts

object[]

Show child attributes

acquirer

object

Contains information about the merchant's financial institution.

Show child attributes

business

object

Contains customer-provided information about the business that funded the transaction.

Show child attributes

duration

integer<int32>

Duration of the transaction on Marqeta's servers, in milliseconds.

merchant

object

Show child attributes

polarity

enum<string>

Indicates whether the transaction is credit or debit.

Available options:

CREDIT,

DEBIT,

PENDING_CREDIT,

PENDING_DEBIT

response

object

Response codes and memos for account name verification, address verification, card security verification, and transactions.

Show child attributes

sub_type

string

gpa_order

object

Contains information about a GPA order, including fees, funding sources, and addresses. See <</core-api/gpa-orders, GPA Orders>> for more information.

Show child attributes

bin_prefix

string

read-only

Required string length: 8

card_token

string

Unique identifier of the card. Useful when a single account holder has multiple cards.

Maximum string length: 36

chargeback

object

Contains the chargeback object associated with this transaction if a chargeback has been initiated.

Show child attributes

fleet_data

object

Contains details about fleet program transactions.

Show child attributes

identifier

string

Sequential identifier of the transaction.

standin_by

string

Indicates which party approved a transaction: the card network using stand-in processing, or Marqeta using Commando Mode.

subnetwork

string

Indicates which subnetwork was used to complete the transaction. Possible values include the following:

VISANET – Used for VisaNet signature-based transactions.
VISANETDEBIT – Used for VisaNet Debit PIN-based transaction.
VISAINTERLINK – Used for Visa Interlink PIN-based transactions.
VISAPLUS – Used for ATM withdrawals on Visa.
MAESTRO – Used for PIN-based transactions on Mastercard.
CIRRUS – Used for ATM withdrawals on Mastercard.
MASTERCARDDEBIT – Used for signature-based transactions on Mastercard.
GATEWAY_JIT – Used for Gateway JIT Funding transactions.
MANAGED_JIT – Used for Managed JIT Funding transactions or for transactions that occur while Commando Mode is enabled.

to_account

string

Specifies the receiving account type.

user_token

string

Unique identifier of the user who owns the account that funded the transaction; subsequent related transactions retain the same user_token, even if the card used to complete the transaction moves to another user.

Maximum string length: 36

auto_reload

object

Contains information about an auto reload. See <</core-api/auto-reload, Auto Reloads>> for more information.

Returned if an auto reload was executed.

Show child attributes

batch_number

string

The batch number of the transaction.

created_time

string<date-time>

Date and time when the Marqeta platform created the transaction entry, in UTC format. For example, when Marqeta processed the clearing record for a refund.

fee_transfer

object

Contains information about a fee charge, including the amount, currency code, and user or business token.

Show child attributes

from_account

string

Specifies the funding account type.

isaIndicator

enum<string>

The international service assessment indicator indicates if an ISA fee is applicable to the transaction.

Available options:

MULTI_CURRENCY,

SINGLE_CURRENCY,

REBATE_CANCELLED,

MULTI_CURRENCY_NON_US_COUNTRIES,

SINGLE_CURRENCY_PAID_BY_ISSUER,

NO_CHARGE_ASSESSED

account_owner

object

Information about the owner of an account participating in an account funding or original credit transaction.

Show child attributes

approval_code

string

Unique identifier assigned to an authorization, printed on the receipt at point of sale.

card_acceptor

object

Contains information about the merchant.

Show child attributes

currency_code

string

Currency type of the transaction.

issuer_script

object

Show child attributes

peer_transfer

object

Contains information about an intra-account transfer, including sender and recipient tokens, transfer amount, and currency code.

Show child attributes

visa_pop_code

string

business_token

string

Unique identifier of the business that owns the account that funded the transaction.

Maximum string length: 36

direct_deposit

object

Contains information about a direct deposit.

Show child attributes

request_amount

number

Merchant-requested amount, including any fees.

standin_reason

string

Indicates why the card network handled a transaction requiring stand-in processing.

account_funding

object

Contains details about account funding transactions. Account funding transactions move money into a cardholder's general purpose account (GPA).

Show child attributes

atc_information

object

Show child attributes

original_credit

object

Contains information about an original credit transaction (OCT), which enables the cardholder to receive funds on the specified card from an external source via the card network.

Show child attributes

settlement_date

string<date-time>

Date and time when funds were moved for a transaction, in UTC. For example, in the case of a refund, when funds were credited to the cardholder.

vdcap_qualified

boolean

cash_back_amount

number

Amount of cash back requested by the cardholder during the transaction. Included in the total transaction amount.

cashloads_direct

object

Show child attributes

gpa_order_unload

object

Contains information about a GPA unload order.

Show child attributes

installment_data

object

Contains the installment plan identifier used by the Visa Transaction Matching Service for Issuers.

Show child attributes

network_metadata

object

Contains network-related metadata for the transaction, including details about the card program and the card product. Returned if provided by the card network

Show child attributes

program_transfer

object

Contains information about a program transfer, which moves funds from an account holder's GPA to a program funding source.

Show child attributes

stop_order_token

string

Token of the ACTIVE stop order that caused this recurring transaction to be declined. Present only on transactions declined for a cardholder stop-payment request (response code 1949); absent otherwise.

card_holder_model

object

Contains information about a cardholder.

Show child attributes

cardholder_impact

boolean

is_final_clearing

boolean

Indicates the final clearing event for an authorization. If the final cleared amount is lower than the authorized amount, you must release the hold on the funds per the value in the amount_to_be_released field.

advice_reason_code

string

Extended stand-in processing (STIP) reason code, as provided by the card network.

anticipated_amount

number

Anticipated amount of the transaction, as provided by the card network. This field applies to anticipated amount verification transactions (AAVTs).

card_product_token

string

Unique identifier of the card product.

Maximum string length: 36

from_account_token

string

acquirer_fee_amount

number

Indicates the amount of the acquirer fee. Account holders are sometimes charged an acquirer fee for card use at ATMs, fuel dispensers, and so on.

bank_transfer_token

string

currency_conversion

object

Contains information about currency conversion.

Show child attributes

enhanced_data_token

string

The enhanced commercial card data token for the transaction.

is_offline_approved

string

Indicates that the card and terminal approved the transaction offline locally, without real-time issuer approval. Included only on transactions approved offline; omitted for all other transactions.

is_preauthorization

boolean

default:false

Indicates if the transaction is a pre-authorization.

issuer_payment_node

string

Unique identifier of the Marqeta platform server that received the transaction from the card network.

payment_facilitator

object

Information about the payment facilitator of an account funding or original credit transaction.

Show child attributes

real_time_fee_group

object

Contains information about a real-time fee group.

Show child attributes

standin_approved_by

string

Indicates which party approved a transaction: the card network using stand-in processing, or Marqeta using Commando Mode. Returned only when a transaction is approved.

address_verification

object

Contains address verification data consisting of address data entered by the cardholder, address data held by the Marqeta platform, and an assertion by the Marqeta platform as to whether the two sets of data match.

Show child attributes

digital_wallet_token

object

Contains information about the digital wallet that funded the transaction.

Returned for all transactions funded by a digital wallet or related to digital wallet token provisioning.

For more on digital wallets, see the <</core-api/digital-wallets-management, Digital Wallets Management>> API reference and <</developer-guides/digital-wallets-and-tokenization, Digital Wallets and Tokenization>> developer guide.

Show child attributes

issuer_received_time

string

Date and time when the Marqeta platform received the transaction from the card network, in UTC.

network_reference_id

string

Network-assigned unique identifier of the transaction. Useful for settlement and reconciliation.

reconciliation_cycle

string

settlement_indicator

string

Indicates the settlement service used for the transaction.

transaction_metadata

object

Contains merchant-provided metadata related to the transaction, including details about lodging- and transit-related purchases.

May be returned if the request uses Transaction Model v2 of the Marqeta Core API. Not returned for Transaction Model v1 requests.

Show child attributes

acquirer_reference_id

string

Acquirer-assigned unique identifier of the transaction. Useful for settlement and reconciliation.

advice_reason_details

string

Extended stand-in processing (STIP) reason details, as provided by the card network.

amount_to_be_released

number

Amount of original authorization to be released. This field appears in final clearing transactions where the clearing amount is lower than the authorization amount.

preceding_transaction

object

Returned for authorization.clearing transaction types following a financial advice.

Contains information about the preceding transaction.

Show child attributes

user_transaction_time

string<date-time>

Date and time when the user initiated the transaction, in UTC. For example, when a merchant performed the original authorization for a refund.

local_transaction_date

string<date-time>

Indicates the local time of the transaction at the card acceptor's location. You can use this field to determine the correct time of the transaction when filing a dispute.

transaction_attributes

object

Additional transaction attributes.

Show child attributes

acquirer_reference_data

string

Acquirer-assigned unique identifier of the transaction. Useful for settlement and reconciliation.

cardholder_verification

object

Show child attributes

estimated_authorization

boolean

Indicates an estimated authorization. An estimated authorization allows the merchant to obtain an approval for funds before the cardholder has finalized exactly what goods or services will be purchased.

authorization_expiration

string<date-time>

deferred_settlement_days

string

original_settlement_date

string<date-time>

account_name_verification

object

Contains name verification data: the full name entered by the cardholder, name data held by the Marqeta platform, and an assertion by the Marqeta platform as to whether the two sets of data match.

Show child attributes

issuer_interchange_amount

number

The amount of interchange charged by the card issuer.

velocity_control_balances

object

Show child attributes

original_transaction_token

string

Unique identifier of the original transaction in a series of related transactions.

interchange_rate_descriptor

string

national_net_cpd_of_original

string

program_reserve_deposit_info

object

Show child attributes

multi_clearing_sequence_count

string

If an authorization has multiple clearing transactions, this field displays their total number. For example, if an authorization has four clearing transactions, the sequence count is 04.

cardholder_authentication_data

object

Contains authentication data for 3D Secure and digital wallet token transactions:

electronic_commerce_indicator – The level of verification performed.
verification_result – The result of the verification.
verification_value_created_by – The transaction participant who determined the verification result.
three_ds_message_version – The 3D Secure message version used for authentication.
authentication_method – The 3D Secure authentication method.
authentication_status – The 3D Secure authentication status.
acquirer_exemption – Indicates a 3D Secure authentication exemption from the acquirer.
issuer_exemption – Indicates a 3D Secure authentication exemption from the issuer.
cavv_authentication_amount – CAVV authentication amount.
raw_cavv_data – Raw CAVV data provided by the card network.

Show child attributes

multi_clearing_sequence_number

string

If an authorization has multiple clearing transactions, this field displays the sequence number for the clearing transaction. For example, if this is the second clearing transaction of four, the sequence number is 02.

strong_customer_authentication

object

Strong Customer Authentication information for contactless transactions

Show child attributes

card_security_code_verification

object

Contains information about a verification check performed on the card's security code.

Show child attributes

clearing_record_sequence_number

string

A sequence number that identifies a specific clearing message among multiple clearing messages for an authorization.

network_transaction_lifecycle_id

string

Transaction identifier, as provided by the card network. This identifier connects the original transaction to all subsequent activities throughout the transaction lifecycle.

relay_resistance_protocol_result

string

Returned for final transaction types.

Unique identifier of the preceding related transaction. Useful for identifying the transaction that preceded the current one.

For example, authorization, a temporary transaction type, precedes and is completed by authorization.clearing, a final transaction type. In this case, the authorization token is returned with this field. For which transaction types are temporary or final, see <</core-api/event-types#_transaction_events, Transaction events in Event Types>>.

merchant_initiated_original_trace_id

string

Unique network identification value formed by combining the 6- to 9-character Mastercard Banknet Reference Number and the 4-digit settlement date for recurring payments and other merchant-initiated transactions.

original_interchange_rate_descriptor

string

digital_commerce_solutions_indicators

object

Show child attributes

digital_commerce_authentication_program

object

Show child attributes

digital_commerce_authentication_indicator

string

Visa Digital Commerce Authentication Program (VDCAP) indicator for U.S. domestic card-not-present transactions. Indicates the presence of key data elements, along with the eligible method used to share authentication data.

02: Visa Secure
03: Visa data only
04: Visa Payment Passkey with Visa Secure
05: Visa Payment Passkey with Visa Token Service
06: IDX 3rd party
07: Visa Token Service data only

original_network_transaction_lifecycle_id

string

incremental_authorization_transaction_tokens

string[]

An array of incremental authorization transaction tokens.

digital_wallet_token_transaction_service_provider_info

object

Show child attributes

Getting Started

Testing

Card Issuing

Card Processing

Accounts & Money Movement

Risk, Fraud, and Disputes

Cardholder User Experience