Fields
UUID!
Unique identifier of the declined transaction.
String!
Type of transaction that was declined, e.g. “Gift Card Purchase”, “Virtual Card Purchase”, “Add Money”, “Withdrawal”, “Transfer - Out”, “Bill Payment Initiation”, “Issue Virtual Card”.
Float!
Total transaction amount that was attempted, in the transaction’s currency.
Float!
Portion of the attempted amount that would have been funded from Fluz internal balances (cash/rewards/reserve/prepayment activity). Defaults to 0 when not applicable.
Float!
Portion of the attempted amount that would have been funded from an external funding source (e.g. linked bank/card). Defaults to 0 when not applicable.
String!
ISO 4217 currency code for the transaction amount. Defaults to “USD” when not specified on the record.
String
Type of the originating source record that produced this declined transaction (e.g. the originating domain/entity type).
String
Identifier of the originating source record that produced this declined transaction.
String!
Identifier of the Fluz account that owns the transaction.
String
Identifier of the user who attempted the transaction. May be absent for account-level/system transactions.
String
Source of funds / origin label for the transaction (e.g. funding source or originating party).
String
Destination of the transaction (e.g. merchant or recipient label). For merchant transactions this is typically the merchant.
DeclinedTransactionStatus!
Outcome status of the transaction. One of DeclinedTransactionStatus: “DECLINED” or “FAILED”.
String
Identifier of the merchant associated with the transaction, when known.
String
Identifier of the resolved merchant descriptor used to enrich merchant metadata.
String
Identifier of the liability record associated with the transaction, when applicable.
String
Display name of the merchant. Populated from the transaction destination when a merchant is identified; otherwise null.
String
Country of the merchant.
String
City of the merchant.
String
State/region of the merchant.
String
URL of the logo to display for the transaction (typically the merchant/brand logo).
String
Category/classification of the transaction or merchant.
String
Last four digits of the card used for the transaction.
String
Human-friendly display name of the card used for the transaction.
String
Identifier of the virtual card involved in the transaction, when applicable.
String
Virtual card program/issuer label for the virtual card, when applicable.
String
Channel through which the transaction was initiated (e.g. app, web, integration).
String
Type of the external funding source used (e.g. bank account, debit card).
String
Identifier of the external funding source used.
String
Subtype of the funding source (e.g. checking vs. savings, card network subtype).
Boolean!
True if the user’s cash balance was applied/attempted for this transaction.
Boolean!
True if the gift-card prepayment balance was applied/attempted for this transaction.
Boolean!
True if the rewards balance was applied/attempted for this transaction.
Boolean!
True if the reserve balance was applied/attempted for this transaction.
String!
Timestamp of the transaction, as an ISO 8601 datetime String (derived from the record’s creation time).
String
Nickname of the spend account used. Falls back to “Main account” when no specific nickname is set.
String
Short, user-facing title summarizing the decline (from the resolved decline display content).
String
User-facing reason explaining why the transaction was declined.
String
Longer user-facing description providing additional detail about the decline.
String
Call-to-action text suggesting the next step the user can take in response to the decline.
String
Categorization of the decline (used to group/route decline messaging).
UUID
Identifier of the offer associated with the transaction, when applicable.
String
Card issuer associated with the card/transaction.
String
Bank Identification Number (first digits) of the card used.
String
Spend-limit amount relevant to the decline (e.g. the limit that was exceeded), as a String.
String
Duration/window the spend limit applies to (e.g. per-transaction, daily, monthly).
String
Indicates whether the card is set to lock on next use.
String
Date associated with a card lock, when applicable.
String
Nickname of the bank account associated with the funding source, when derivable.
String
Last four digits of the bank account associated with the funding source.
Boolean
Privacy flag indicating whether the transaction should be treated as private.
DateTime!
Timestamp when the transaction was created.
DateTime!
Timestamp when the transaction was last updated.