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
).
- Codes —
AAAU
,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
- AAAU
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: |
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: |
amti | AAAU only. Amount of the transaction in cents. The amount is signed: |
|
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: |
auth_id_response | Authorization identification response, a numeric code that Galileo returns to a merchant to verify that the transaction was authorized. DE038. Example: |
|
auth_tran_type | Based on DE003, processing code. Type of authorization request. See Authorization types for possible values. Example: |
|
avail_cash | For debit accounts, the |
|
avail_credit | For credit accounts, the available credit limit to spend. Example: |
|
balance_id | X | The balance ID, also called the |
billing_amt | Amount to be billed in the currency of the cardholder account (DE006). Example: |
|
billing_curr_code | Currency code for |
|
cad | X | Galileo-generated card ID. Example: |
card_not_present | AAAU only. Whether this is a card-not-present transaction. |
|
cashback_amount | Amount of the transaction that is cashback instead of purchase. This amount is included in |
|
ch_group_id | Corporate Hierarchy group identifier. Example: |
|
client_id | ID for the customer record. Example: |
|
credit_balance | For credit accounts, the total amount of unpaid purchases and advances. Example: |
|
credit_ind | Whether the transaction arrived at Galileo over credit or debit rails. |
|
currency | Currency code for |
|
de003 | Raw contents of DE003, processing code. See DE003 Codes for possible values. Example: |
|
de022 | Raw contents of DE022, POS entry mode. See DE022 Codes for possible values. Example: |
|
de25 | AAAU only. Raw contents of DE025 for Visa and Discover, POS condition. See DE025 Codes for possible values. Example: |
|
domestic is_domestic |
Whether this is a domestic transaction. |
|
fee_amount | Program transaction fee. Example: |
|
financial_network_code | The financial bank card product or branding of the card. DE063SE1. Valid values: |
|
fleet_card_driver_number | Fleet cards only. Driver ID. Example: |
|
fleet_card_vehicle_number | Fleet cards only. Vehicle ID. Example: |
|
fund_pastotb_adj | The available balance of the RTF or Corporate Credit funding account after this transaction takes place. Example: |
|
fund_pmt_ref_no | The PRN of the RTF or Corporate Credit funding account that is associated with this spending account. Example: |
|
latest_incremental_id | The |
|
local_currency | Currency code for |
|
local_currency_amount | Amount of the transaction in the currency at the point of sale (DE004). No fees or upcharges included. Example: |
|
local_surcharge_amt local_atm_surcharge |
The surcharge amount (DE028) added by the merchant or ATM operator. This amount is included in |
|
match_results | AAAU only. Results of an account name inquiry (ANI). |
|
mc_installment_pmt_data | Contents of DE112 SE7. See MSI Installments data to interpret the code. Example: |
|
mc_promotion_code | Contents of DE048 SE95. See MSI Installments data to interpret the code. Example: |
|
mcc | X | Merchant category code (DE018). Example: |
merchant | AAAU only. Concatenation of |
|
merchant_location | X | Merchant city and state (from remaining part of ISO DE043). Example: |
merchant_name | X | Merchant name (first 22 characters of DE043). Should not be used for matching; instead, use |
merchant_number | X | Merchant number (DE042). Example: |
merchant_postal_code | The postal code for the merchant. Example: |
|
msg_event_id | Unique Galileo-generated identifier for this message. Example: |
|
msg_id | The four-letter code to identify this event. Example: |
|
mti | BAUT only. ISO 8583 message-type indicator. 4 digits. Example: |
|
network | X | See Events Network Codes for possible values. Example: |
open_to_buy | X | The available balance to spend. Example: |
opentobuy_ts | The exact date-time at which |
|
original_auth_id | X | The |
original_incremental_id | The |
|
otype | X | See Transaction Types for possible values. Example: |
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: |
prod_id | X | The product ID of the account. Example: |
prog_id | X | The program ID of the account. Example: |
response_code | X | See Authorization Response Codes for possible values. Example: |
response_reasons | Pipe-delimited list of factors that were calculated for |
|
risk_score | Risk score provided by the network. Higher numbers mean higher risk. Example: |
|
rrn | Retrieval reference number (DE037). Format: Julian date |
|
rules_results | X | Comma-delimited list of DENY, WARN or FREEZE rules from Galileo's dynamic fraud engine. Example: |
settle_currency | Currency code for |
|
settle_currency_amount | Amount of the transaction in the settlement currency. Example: |
|
sign_amount | Contains |
|
stan | System trace audit number, a unique identifier assigned to each transaction by the originator of the message. DE011. Example: |
|
timestamp | X | Date-time when this event was created in Mountain Standard Time (GMT -0700). Format: |
tlid | Mastercard only. Transaction link identifier. An identifier that Mastercard generates for every original transaction. DE105SF1. Example: |
|
token_requester | BAUT only. Name of the entity that is requesting a tokenized version of the card. Example: |
|
token_requester_id | BAUT only. Identifier for |
|
token_type | Name of token requester. Example: |
|
type | X | The name of this event: |
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: |
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"
}