auth

An authorization request was approved. The available balance has changed.

Event code AAAU is for completions (advice), reversal notifications, AVS-only checks, and yellow-path tokenization requests.

Event code BAUT is for all other authorization requests except ATM balance inquiries (AABI: bal) and card loads (AAPM: auth_payment).

  • CodesAAAU, BAUT
  • Event trigger — You or Galileo approve an authorization request.
  • Processes — These processes contain the event trigger:
    • AAAU
      Galileo receives one of these messages from the card network:
      • Preauthorization completion
      • Preauthorization reversal
      • Reversal notification
      • AVS-only request
      • A tokenization request that entered the yellow path
      • Advice notification of an approved STIP transaction
    • BAUT
      Galileo receives one of these messages from the card network:
      • Preauthorization request
      • Authorization request

Fields

The data elements (DEs) in the field descriptions may vary by network. All fields are strings. Your field names may vary. Default fields are included in the default webhook template. See Default and optional fields for more information.

Field Default Description
act_type X

See Activity Type for possible values. This field is not returned for AAAU messages that have no dollar amount. Example: "VI"

amount X

BAUT only. The amount of the authorization request. Includes fees and upcharges. DE004 times the conversion rate in DE009. The amount is signed: - to debit the account and + to credit the account. Example: "10.25"

amti

AAAU only. Amount of the transaction in cents. The amount is signed: - to debit the account and + to credit the account. Example: "26100"

auth_api_request

BAUT only. Contents of the Auth API webhook payload for this transaction. Stringified JSON.

auth_id X

Galileo-generated ID for the authorization request. This ID is unique per subnetwork. Example: "12303090"

auth_id_response

Authorization identification response, a numeric code that Galileo returns to a merchant to verify that the transaction was authorized. DE038. Example: "012547"

auth_tran_type

Based on DE003, processing code. Type of authorization request. See Authorization types for possible values. Example: "5"

avail_cash

For debit accounts, the open_to_buy plus available overdraft. Example: "143.11"

avail_credit

For credit accounts, the available credit limit to spend. Example: "432.00"

balance_id X

The balance ID, also called the galileo_account_number. Example: "20211"

billing_amt

Amount to be billed in the currency of the cardholder account (DE006). Example: "24.35"

billing_curr_code

Currency code for billing_amt (DE051). Example: "840"

cad X

Galileo-generated card ID. Example: "12534"

card_not_present

AAAU only. Whether this is a card-not-present transaction. Y is card-not-present; N is card-present. Example: "Y"

cashback_amount

Amount of the transaction that is cashback instead of purchase. This amount is included in amount. Example: "20.00"

ch_group_id

Corporate Hierarchy group identifier. Example: "2544"

client_id

ID for the customer record. Example: "264539"

credit_balance

For credit accounts, the total amount of unpaid purchases and advances. Example: "325.00"

credit_ind

Whether the transaction arrived at Galileo over credit or debit rails. Y is credit; N is debit. Example: "Y"

currency

Currency code for amount, which is the currency of the cardholder account. Example: "840"

de003

Raw contents of DE003, processing code. See DE003 Codes for possible values. Example: "002000"

de022

Raw contents of DE022, POS entry mode. See DE022 Codes for possible values. Example: "071"

de25

AAAU only. Raw contents of DE025 for Visa and Discover, POS condition. See DE025 Codes for possible values. Example: "00"

domestic
is_domestic

Whether this is a domestic transaction. Y is domestic; N is international. Example: "Y"

fee_amount

Program transaction fee. Example: "2.00"

financial_network_code

The financial bank card product or branding of the card. DE063SE1. Valid values: CI (Cirrus), MC (Mastercard credit), MD (Debit Mastercard), MS (Maestro), PL (Visa Plus), PV (Private Label), VI (Visa) Example: "MS"

fleet_card_driver_number

Fleet cards only. Driver ID. Example: "06123456"

fleet_card_vehicle_number

Fleet cards only. Vehicle ID. Example: "03123"

fund_pastotb_adj

The available balance of the RTF or Corporate Credit funding account after this transaction takes place. Example: "24365.90"

fund_pmt_ref_no

The PRN of the RTF or Corporate Credit funding account that is associated with this spending account. Example: "122101354223"

latest_incremental_id

The auth_id of the previous authorization in an incremental sequence. May contain the same value as original_auth_id. Example: "12303085"

local_currency

Currency code for local_currency_amount (DE049). Example: "124"

local_currency_amount

Amount of the transaction in the currency at the point of sale (DE004). No fees or upcharges included. Example: "1245.20"

local_surcharge_amt
local_atm_surcharge

The surcharge amount (DE028) added by the merchant or ATM operator. This amount is included in amount. Example: "2.50"

match_results

AAAU only. Results of an account name inquiry (ANI). L — last name; M — middle name; F — first name. Values are 01 — match; 50 — partial match; 99 — no match. Example: L:'01', F:'01', M: ''

mc_installment_pmt_data

Contents of DE112 SE7. See MSI Installments data to interpret the code. Example: "030600484"

mc_promotion_code

Contents of DE048 SE95. See MSI Installments data to interpret the code. Example: "MEXCTA"

mcc X

Merchant category code (DE018). Example: "5712"

merchant

AAAU only. Concatenation of merchant_name and merchant_location. Example: "RIDESHARE.COM/CHARGES, SAN FRANCISCO, CA"

merchant_location X

Merchant city and state (from remaining part of ISO DE043). Example: "NEW YORK, NY"

merchant_name X

Merchant name (first 22 characters of DE043). Should not be used for matching; instead, use merchant_number. Example: "Widgets Incorporated"

merchant_number X

Merchant number (DE042). Example: "L4DIV6D5LM4X7LF"

merchant_postal_code

The postal code for the merchant. Example: "10021"

msg_event_id

Unique Galileo-generated identifier for this message. Example: "243693"

msg_id

The four-letter code to identify this event. Example: "AAAU"

mti

BAUT only. ISO 8583 message-type indicator. 4 digits. Example: "0200"

network X

See Events Network Codes for possible values. Example: "V"

open_to_buy X

The available balance to spend. Example: "500.00"

opentobuy_ts

The exact date-time at which open_to_buy was captured. Format: YYYY-MM-DD hh:mm:ss.ssssss Example:"2025-03-17 14:06:50.243654"`

original_auth_id X

The auth_id of the previous authorization in a sequence. For a completion, this is the auth_id of the preauthorization. For a reversal, this is the auth_id of the transaction that is being reversed. For an incremental sequence, this is the auth_id of the previous authorization in the sequence. Example: "12303085"

original_incremental_id

The auth_id of the first authorization in an incremental sequence. Example: "12302001"

otype X

See Transaction Types for possible values. Example: "W"

pastotb

BAUT only. The available balance immediately after the authorized amount was applied to the cardholder account.

pmt_ref_no X

Galileo 12-digit payment reference number (PRN) for the account. Example: "999101003022"

prod_id X

The product ID of the account. Example: "1701"

prog_id X

The program ID of the account. Example: "305"

response_code X

See Authorization Response Codes for possible values. Example: "05"

response_reasons

Pipe-delimited list of factors that were calculated for response_code. Example: "Acquiring merchant blocked by product|Suspected fraud"

risk_score

Risk score provided by the network. Higher numbers mean higher risk. Example: "26"

rrn

Retrieval reference number (DE037). Format: Julian date YDDDxxxxxxxx Example: "314293027549"

rules_results X

Comma-delimited list of DENY, WARN or FREEZE rules from Galileo's dynamic fraud engine. Example: "hr_crypto:DENY, intl_cnp_ecom:DENY"

settle_currency

Currency code for settle_currency_amount. Example: "840"

settle_currency_amount

Amount of the transaction in the settlement currency. Example: "35.44"

sign_amount

Contains - (minus sign) when the amount debits the open_to_buy. Example: "-"

stan

System trace audit number, a unique identifier assigned to each transaction by the originator of the message. DE011. Example: "000803"

timestamp X

Date-time when this event was created in Mountain Standard Time (GMT -0700). Format: YYYY-MM-DD hh:mm:ss MST Example: "2025-01-31 17:20:33 MST"

tlid

Mastercard only. Transaction link identifier. An identifier that Mastercard generates for every original transaction. DE105SF1. Example: "f3a54c321e634e9b"

token_requester

BAUT only. Name of the entity that is requesting a tokenized version of the card. Example: "Apple Inc."

token_requester_id

BAUT only. Identifier for "token_requester". Example: "40010030273"

token_type

Name of token requester. Example: "Apple Inc."

type X

The name of this event: "auth"

user_data

Populated according to your use case and needs by arrangement with Galileo.

visa_trans_id

Contents of Field 62.2: Transaction Identifier (bitmap format). This Visa-generated transaction ID is unique for each original authorization and financial request. Example: "141037867734271"

Example

# auth example:
{
  "act_type": "AU",
  "amount": "-77.00",
  "auth_id": "12303090",
  "auth_id_response": "012547",
  "balance_id": "20211",
  "billing_amt": "77",
  "billing_curr_code": "840",
  "cad": "12534",
  "card_not_present": "N",
  "ch_group_id": "2544",
  "client_id": "264539",
  "currency": "840",
  "financial_network_code": "MS",
  "fleet_card_driver_number": "06123456",
  "fleet_card_vehicle_number": "03123",
  "latest_incremental_id": "12303085",
  "local_currency": "840",
  "mc_installment_pmt_data": "030600484",
  "mc_promotion_code": "MEXCTA",
  "mcc": "5712",
  "merchant_location": "PERRY, GA",
  "merchant_name": "AT&T RNCP 136300",
  "merchant_number": "000844017654881",
  "mti": "110",
  "network": "M",
  "open_to_buy": "-7.58",
  "original_auth_id": "12303085",
  "original_incremental_id": "12302001",
  "otype": "A",
  "pmt_ref_no": "999101003022",
  "prod_id": "1701",
  "prog_id": "305",
  "response_code": "00",
  "sign_amount": "-",
  "stan": "000803",
  "timestamp": "2025-01-31 17:20:33 MST",
  "tlid": "f3a54c321e634e9b",
  "token_requester_id": "50110030273",
  "token_type": "Apple Inc.",
  "type": "auth",
  "visa_trans_id": "141037867734271"
}