Skip to content
StartupBuilder
by startups.studio
by Startups.Studio
Business
Changelog
Events

Transaction.failed

The rail refused a charge or payout Transaction after it was sent.

PropertyValue
Raised byNo Verb: the rail raises it
NounTransaction
MovesBill paid to approved when the rail refused the Transaction that paid this Bill
WakesNone.

Payload

Each delivery is an Event record. data holds the Transaction as it stands.

FieldTypeRequiredDescription
namestringrequiredTransaction.failed.
atdatetimerequiredWhen it happened.
seqintegerIts position in the namespace, one more than the Event before; any seq is a cursor into the history.
datajsonrequiredThe Thing as the Action left it.
data.transactionTransactionrequiredThe Transaction as the change left it.
data.transaction.kindstringrequiredOne of charge, refund, payout, or transfer.
data.transaction.amountmoneyrequiredThe amount moved.
data.transaction.receiptFileThe receipt matched to a card Transaction.
data.transaction.settledAtdatetimeWhen the money became available in a cash Account.
data.reasontextrequiredWhy the rail refused it, in the rail’s words.

Example

JSON
{
  "$id": "https://api.sb/leaseline.app/events/evt_QoYICDL4sO",
  "$type": "Event",
  "name": "Transaction.failed",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "transaction": {
      "$id": "https://api.sb/leaseline.app/transactions/txn_XoxtZe3CQI",
      "$type": "Transaction",
      "kind": "charge",
      "amount": {
        "amount": 29,
        "currency": "USD"
      },
      "receipt": "file_V1AuhyCTsH",
      "settledAt": "2026-10-22T12:00:00Z"
    },
    "reason": "The bank declined the transfer."
  },
  "seq": 2674
}