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) indicated in the field descriptions may vary by network. All fields are strings. Your field names may vary.
Field | Required | Description |
---|---|---|
act_type | X | See Activity Type for possible values. 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 for this transaction. Stringified JSON. |
|
auth_id | X | Galileo-generated ID for the authorization request. This ID is unique per subnetwork. 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 |
|
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, POS condition. See DE025 Codes for possible values. Example: |
|
domestic is_domestic |
Whether this is a domestic transaction. |
|
fee_amount | Program transaction fee. Example: |
|
fleet_card_driver_number | Driver ID. Fleet cards only. Example: |
|
fleet_card_vehicle_number | Vehicle ID. Fleet cards only. Example: |
|
fund_pastotb | The available balance of the real-time funding account after this transaction takes place. Example: |
|
fund_pmt_ref_no | The PRN of the real-time funding account that is associated with this RTF spending account. Example: |
|
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 |
|
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 | BAUT only. The exact date-time at which |
|
original_auth_id | X | The ID of a prior authorization in the sequence. For example, for a completion, this is 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 settlement in the currency of the cardholder account. Example: |
|
sign_amount | Contains |
|
timestamp | X | Date-time when this event was created in Mountain Standard Time (GMT -0700). Format: |
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. |
Example
# auth example:
{
"act_type": "AU",
"amount": "-77.00",
"auth_id": "12303090",
"balance_id": "20211",
"billing_amt": "77",
"billing_curr_code": "840",
"cad": "12534",
"card_not_present": "N",
"client_id": "264539",
"currency": "840",
"local_currency": "840",
"mcc": "4814",
"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": "0",
"otype": "A",
"pmt_ref_no": "155101003022",
"prod_id": "1701",
"prog_id": "305",
"response_code": "00",
"sign_amount": "-",
"timestamp": "2023-01-29 17:20:33 MST",
"token_requester_id": "50110030273",
"token_type": "Apple Inc.",
"type": "auth"
}