AAAU/BAUT: auth

webhook

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).

Trigger — You or Galileo approve an authorization request.
Processes — These processes contain the event trigger:
- AAAU — SoFi Tech Solutions 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 — SoFi Tech Solutions receives one of these messages from the card network:
  - Preauthorization request
  - Authorization request

Payload

acq_id

string

Acquiring institution identification code. Identifies the acquiring bank or processor that sent the card network message to SoFi Tech Solutions. ISO 8583 DE032.

act_type

string

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

amount

string

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.

amount_sign

string

Indicates whether the value in amount is positive or negative: hyphen (-) for negative or plus sign (+) for positive. Legacy field: sign_amount.

amti

string

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

association_name

string

Acquirer Reference Number (ARN) from the linked adjustment record.

auth_api_request

string

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

auth_exp_date

string

Timestamp for when this authorization entry will expire from the auth database.

auth_id

string

System-generated ID for the authorization request. This ID is unique only per subnetwork.

auth_id_response

string

Authorization identification response, a numeric code that SoFi Tech Solutions returns to a merchant to verify that the transaction was authorized. DE038.

auth_response_code

string

See Authorization Response Codes for possible values.

auth_tran_type

string

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

auth_trans_data

string

Additional transaction JSON data associated with the authorization record.

avail_cash

string

For debit accounts, the open_to_buy plus available overdraft.

avail_credit

string

For credit accounts, the available credit limit to spend.

available_balance

string

The available balance to spend.

available_balance_ts

string

The exact date-time at which open_to_buy was captured. Format: `YYYY-MM-DD hh:mm:ss.ssssss

balance_id

string

The balance ID, also called the galileo_account_number. Legacy field: account_id.

billing_amount

string

Amount to be billed in the currency of the cardholder account (DE006). Legacy field: billing_amt.

billing_curr_code

string

Currency code for billing_amount (DE051).

bookkeeping_auth_id

string

An interim auth_id that is present only when a transaction is being cleared incrementally. See Incremental clearing in the Card Transaction Examples guide for details.

cad

string

System-generated card ID, which has a 1:1 relationship with the PAN. Legacy field: card_id.

card_not_present

string

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

cashback_amount

string

Amount of the transaction that is cashback instead of purchase. This amount is included in amount.

ch_group_id

string

Corporate Hierarchy group identifier.

client_id

string

ID for the customer record.

credit_balance

string

For credit accounts, the total amount of unpaid purchases and advances.

currency_code

string

ISO 4217 numeric currency code for amount (the cardholder account currency). Legacy fields: cur_code, currency.

currency_rate_id

string

Identifier for the currency conversion rate that was applied to this transaction when it is not domestic relative to the card account.

de003

string

Raw contents of DE003, processing code. See DE003 Codes for possible values.

de004

string

Raw contents of DE004, local transaction amount, in the currency at the point of sale. Expressed in cents. The amount is signed: - to debit the account and + to credit the account.

de009

string

Raw contents of DE009, settlement conversion rate.

de022

string

Raw contents of DE022, POS entry mode. See DE022 Codes for possible values.

de11

string

AAAU only. System Trace Audit Number (STAN). A number that a message initiator assigns to uniquely identify a transaction.

de25

string

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

domestic

string

Whether this is a domestic transaction. Y is domestic; N is international.

ds_transaction_id

string

BAUT only, Mastercard only. Directory server transaction ID. A UUID that the merchant passes in the authorization request to link 3DS authentication and authorization data. Mastercard DE048SE66SF2.`

event_ts

string

Timestamp when the message was ingested by SoFi Tech Solutions (Mountain Standard Time). Format: "YYYY-MM-DD hh:mm:ss MST". Legacy fields: timestamp, tran_timestamp.

exp_date

string

The expiration date of the card. Format: MM/DD/YYYY.

external_account_id

string

User-supplied identifier to link to an external system.

fee_amount

string

Program transaction fee.

financial_network_code

string

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).

fund_otb

string

The available balance of the RTF or Corporate Credit funding account before this transaction took place.

fund_pastotb

string

Past available balance of the linked funding account before this transaction.

fund_prn

string

The PRN of the RTF or Corporate Credit funding account that is associated with this spending account. Legacy field: fund_pmt_ref_no.

local_atm_surcharge

string

A fee applied to the ATM withdrawal amount by the ATM's operator. DE028.

local_currency_amount

string

Amount of the transaction in the currency at the point of sale (DE004). No fees or upcharges included. Legacy fields: local_amount, local_amt.

local_currency_code

string

Currency code for local_currency_amount (DE049).

local_surcharge_amt

string

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

match_results

string

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.`

mc_sequence_count

string

BAUT only. Multi-clearing sequence count. Total number of clearings in this sequence.

mc_sequence_number

string

Multi-clearing sequence number. Position of this clearing in the sequence.

mcc

string

Merchant category code (DE018).

merchant

string

AAAU only. Concatenation of merchant_name and merchant_location.

merchant_country_code

string

Mastercard credit only. The 3-letter code of the country where the merchant is officially located (ISO 3166-1).

merchant_location

string

Merchant city and state (from remaining part of ISO DE043). Legacy field: merch_loc.

merchant_name

string

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

merchant_number

string

Merchant number (DE042). Legacy field: merch_num.

merchant_postal_code

string

The postal code for the merchant.

method

string

Event category. Indicates the type of event.

msg_event_id

string

Unique SoFi Tech Solutions-generated identifier for this message.

msg_id

string

The four-letter code to identify this event.

msg_type_flag

string

Message type flag from the source auth record indicating the type of card network message.

mti

string

BAUT only. ISO 8583 message-type indicator. 4 digits.

network

string

See Events Network Codes for possible values.

original_auth_id

string

The auth_id of the previous authorization in a sequence. For 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.

original_incremental_id

string

The auth_id of the first authorization in an incremental sequence.

otype

string

See Transaction Types for possible values.

pastotb

string

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

prn

string

SoFi Tech Solutions 12-digit payment reference number (PRN) for the account. Legacy field: pmt_ref_no.

proc_code

string

Processing code, derived from positions 1-2 of DE003. The type of transaction being processed.

prod_id

string

The product ID of the account.

prog_id

string

The program ID of the account.

response_reasons

string

Pipe-delimited list of factors that were calculated for response_code.

risk_score

string

Risk score provided by the network. Higher numbers mean higher risk.

rrn

string

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

rules_results

string

Comma-delimited list of DENY, WARN or FREEZE rules from SoFi Tech Solutions's dynamic fraud engine.`

settle_currency_amount

string

Amount of the transaction in the settlement currency.

settle_currency_code

string

Currency code for settle_currency_amount.

signature_ind

string

Indicates whether this is a signature or a PIN transaction.

stan

string

BAUT only. System trace audit number, a unique identifier assigned to each transaction by the originator of the message. DE011.

tlid

string

Mastercard only. Transaction link identifier. An identifier that Mastercard generates for every original transaction. DE105SF1.

token_id

string

Unique identifier for the token, provided by the card network. Called "Token Unique Reference" (TUR) by Mastercard and "Token Reference ID" by Visa.

token_requester_id

string

BAUT only. Identifier for "token_requester".

token_type

string

Name of token requester.

type

string

The name of this event: "auth"

user_data

string

Populated according to your use case and needs by arrangement with SoFi Tech Solutions.

visa_trans_id

string

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

Loading…