API Reference
Log into Sandbox

SETL: setl

webhook
setl

A transaction was settled. The amount has been posted to the specified account. Available balance has changed only if the settlement amount was different from the authorization amount or if the transaction was force-posted. For information on multi-clearing settlements, see Incremental clearing in the Settlement guide.

  • Trigger — One of the following takes place:

    • Galileo matches the transaction in the card network's batch file with a transaction in its database and posts the settlement.
    • Galileo receives a clearing message for a transaction for which there is no matching authorization and posts the settlement.

  • Processes — These processes contain the event trigger:

    • SoFi Tech Solutions receives a clearing batch file from a card network, and SoFi Tech Solutions compares the transactions in the batch file with its own authorization records.
Payload
string

The tax ID associated with the transaction. This is also known as the Domestic Card Acceptor Tax ID. Required for clients operating in LATAM.

string

See Activity Type for possible values.

string

Amount of the activity record. Signed (negative for debits).

string

Activity type code for the settlement or adjustment. See Activity Type for possible values.

string

Amount of the settlement.

string

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

string

Acquirer Reference Number for the transaction.

string

Amount of the ATM fee when mcc: 6011. Not included in amount.

string

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

string

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

string

See Authorization Response Codes for possible values.

string

Timestamp of the original authorization. Format: YYYY-MM-DD hh:mm:ss MST

string

For debit accounts, the available_balance plus available overdraft.

string

For credit accounts, the available credit limit to spend.

string

Amount available to spend at the time of the event. Legacy field: balance.

string

Timestamp when available_balance was captured. Format: YYYY-MM-DD hh:mm:ss.ssssss

string

Visa only. Identifier for the B2B program, as provided by Visa.

string

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

string

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

string

Currency code for billing_amount (DE051).

string

Incremental clearing only. The auth_id of the bookkeeping authorization record that is next in the series.

string

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

string

AAAU only. Y if the physical card was not present at the transaction (card-not-present); N otherwise.

string

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

string

Corporate Hierarchy group identifier.

string

ID for the customer record.

string

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

string

Whether a PIN was input at the point of sale: Y (no PIN was input) or N (a PIN was input) or None (not a card transaction, or not processed as a card transaction).

string

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

string

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

string

Additional network information.

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.

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.

string

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

string

The auth_id of the expired authorization that matches this settlement.

string

User-supplied identifier to link to an external system.

string

External activity type code from the settlement record.

string

Visa only. Fee Program Indicator (FPI) is the interchange reimbursement fee program indicator provided by Visa.

string

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

string

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

string

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

string

Interchange fee from the network in the currency of the account.

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.

string

Currency code for local_currency_amount (DE049). Legacy fields: local_curr_code, local_currency.

string

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

string

Contents of PDS0663. See MSI Installments data to interpret the code.

string

Total number of settlements in the sequence.

string

Number in the sequence for this settlement.

string

Merchant category code (DE018).

string

Concatenation of merchant_name and merchant_location.

string

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

string

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

string

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

string

Merchant number (DE042). Legacy field: merch_num.

string

The postal code for the merchant.

string

Merchant state or country code from the settlement record.

string

Event category. Indicates the type of event.

string

Unique system-generated identifier for this message.

string

The four-letter code to identify this event.

string

See Events Network Codes for possible values.

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.

string

The auth_id of the first authorization in an incremental sequence.

string

Incremental clearing only. The auth_id of the original preauthorization.

string

See Transaction Types for possible values.

string

Parsed billing amount as a float.

string

Parsed local currency amount as a float.

string

Parsed settlement amount as a float.

string

Past open-to-buy balance from the activity record — the balance before this event was applied.

string

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

string

Date that the transaction posted to the cardholder account. Format: MM/DD/YYYY.

string

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

string

The product ID of the account.

string

The program ID of the account.

string

Program name associated with the account.

string

Mexico domestic only. The date/time at which usd_amt was calculated. Format: YYYY-MM-DD hh:mm:ss

string

Mexico domestic only. Identifier for rate_value, which was used to calculate usd_amt.

string

Mexico domestic only. Rate from Banco de México. Formula: USD x rate_value = MXP. However, the transaction will settle using the rate from Mastercard.

string

Raw (unrounded) settlement amount before rounding is applied.

string

Visa only. Reimbursement fee calculated by Visa. There are six digits to the right of the decimal, so for example $124.458787 is represented as "124458787".

string

Incremental clearing only. The amount of the preauthorization that has not been cleared yet.

string

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

string

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

string

DENY-type rules as calculated by the SoFi Tech Solutions integrated fraud-detection processes. Legacy field: rules_denied.

string

Settlement amount in the settlement currency.

string

Amount of the settlement in the settlement currency.

string

ISO 4217 numeric currency code for the settlement amount. Legacy field: settle_currency.

string

ID that maps back to the settlement record for the transaction.

string

The amount of the settlement plus a negative sign (-) when the amount debits the open_to_buy. This field is not populated in CV.

string

Current status of the record or external account.

string

Name of token requester.

string

The name of this event: "setl"

string

Mexico domestic only. The amount of the transaction in U.S. dollars, according to the Banco de México rate in rate_value. However, the transaction settles using the Mastercard rate.`

string

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

null

Visa only. Product ID provided by Visa. Consult the Visa documentation on Visa Commercial Choice Omni.

string

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

Updated 1 day ago

Did this page help you?
LoadingLoading…

Updated 1 day ago

Did this page help you?

© SoFi Technology Solutions, LLC 2026    Privacy Disclosure

All documentation, including but not limited to text, graphics, images, and any other content, are the exclusive property of SoFi Technology Solutions, LLC and are protected by copyright laws. These materials may not be reproduced, distributed, transmitted, displayed, or otherwise used without the prior written permission of SoFi Technology Solutions, LLC. Any unauthorized use or reproduction of these materials are expressly prohibited.