transaction_declined.v1

An invalid transaction was declined by a Core system. The debit_credit_indicator field indicates whether the transaction would have debited or credited the account, and the error object contains the reason for the denial.

  • Trigger — An incoming transaction is declined.
  • Processes — These processes contain the event trigger:
    • Internal transaction-validation systems
Payload
string
required

The payment reference number (PRN) of the account.

string

An optional identifier provided by an external system to uniquely identify a transaction in its domain. This ID may be used for reconciliation purposes.

string
required

Identifier for an individual account.

product_and_sub_product
object
required

Object containing the product and subproduct identifiers.

date
required

The business date on which the transaction was attempted. See System and Transaction Dates for more information.

date

The date on which the transaction would have taken effect. See System and Transaction Dates for more information.

transaction_specification
object
required

Predefined transaction and reason codes to specify the type of transaction.

string
enum
required

The type of accounting action.

Allowed:
amount
object
required

The transaction amount that was declined.

string
required

Identifier for the physical location or division within a financial institution or organization that is associated with this operation.

string
length ≤ 200

Free-form field containing customer-facing notes.

string
length ≤ 100

Free-form field containing internal notes for bank use that are not shown to the customer.

string
length ≤ 30

Typically a check number, this numeric value links the current transaction with a processing ticket.

client_metadata
object

Client-reserved field for the transaction, which may have been populated with key/value pairs. Galileo does not populate any data in this field but only stores it for retrieval.

error
object
required

Details about why the transaction was declined.

LoadingLoading…