payment_transaction.updated

Base class for all transaction types in the ledger service

event_type

• const
• enum
• required
  The type of event that occurred.
  Allowed:
  payment_transaction.updated

status

• string
• enum
• required
  The status of the transaction
  Allowed:
  PENDING, SETTLED, DECLINED, REVERSED, CANCELED, RETURNED

token

• uuid
• required
  Unique identifier for the transaction

created

• date-time
• required
  ISO 8601 timestamp of when the transaction was created

updated

• date-time
• required
  ISO 8601 timestamp of when the transaction was last updated

family

• const
• enum
• required
  Allowed:
  PAYMENT

category

• string
• enum
• required
  Transaction category
  Allowed:
  ACH, WIRE, BALANCE_OR_FUNDING_FEE, REWARD, ADJUSTMENT, DERECOGNITION, DISPUTE, CARD, EXTERNAL_ACHE, EXTERNAL_CHECK, EXTERNAL_FEDNOW, EXTERNAL_RTP, EXTERNAL_TRANSFER, EXTERNAL_WIRE, MANAGEMENT_ADJUSTMENT, MANAGEMENT_DISPUTE, MANAGEMENT_FEE, MANAGEMENT_REWARD, MANAGEMENT_DISBURSEMENT, HOLD, PROGRAM_FUNDING

currency

• string
• Currency of the transaction in ISO 4217 format

result

• string
• enum
• required
  Transaction result
  Allowed:
  APPROVED, DECLINED

method_attributes

• required
  Method-specific attributes

• AchMethodAttributes

• WireMethodAttributes

financial_account_token

• uuid
• required
  Financial account token

external_bank_account_token

• uuid | null
• External bank account token

direction

• string
• enum
• required
  Allowed:
  CREDIT, DEBIT

source

• string
• enum
• required
  Allowed:
  LITHIC, EXTERNAL, CUSTOMER

method

• string
• enum
• required
  Allowed:
  ACH_NEXT_DAY, ACH_SAME_DAY, WIRE

settled_amount

• integer
• required
  Settled amount in cents

pending_amount

• integer
• required
  Pending amount in cents

events

• array of objects
• required
  List of transaction events

events

• object
  Note: Inbound wire transfers are coming soon (availability varies by partner bank). Wire-related fields below are a preview. To learn more, contact your customer success manager.

Payment Event

• amount

• integer

• required
  Amount of the financial event that has been settled in the currency's smallest unit (e.g., cents).

• created

• date-time

• required
  Date and time when the financial event occurred. UTC time zone.

• detailed_results

• array of strings
  More detailed reasons for the event
  Allowed:
  APPROVED, DECLINED, FUNDS_INSUFFICIENT, ACCOUNT_INVALID, PROGRAM_TRANSACTION_LIMIT_EXCEEDED, PROGRAM_DAILY_LIMIT_EXCEEDED, PROGRAM_MONTHLY_LIMIT_EXCEEDED

• result

• string

• required
  Allowed:
  APPROVED, DECLINED

• token

• uuid

• required
  Globally unique identifier.

• type

• string

• enum
  Allowed:
  ACH_ORIGINATION_INITIATED, ACH_ORIGINATION_REVIEWED, ACH_ORIGINATION_CANCELLED, ACH_ORIGINATION_PROCESSED, ACH_ORIGINATION_SETTLED, ACH_ORIGINATION_RELEASED, ACH_ORIGINATION_REJECTED, ACH_RECEIPT_PROCESSED, ACH_RECEIPT_SETTLED, ACH_RECEIPT_RELEASED, ACH_RECEIPT_RELEASED_EARLY, ACH_RETURN_INITIATED, ACH_RETURN_PROCESSED, ACH_RETURN_SETTLED, ACH_RETURN_REJECTED, WIRE_TRANSFER_INBOUND_RECEIVED, WIRE_TRANSFER_INBOUND_SETTLED, WIRE_TRANSFER_INBOUND_BLOCKED, WIRE_RETURN_OUTBOUND_INITIATED, WIRE_RETURN_OUTBOUND_SENT, WIRE_RETURN_OUTBOUND_SETTLED, WIRE_RETURN_OUTBOUND_REJECTED

external_id

• string | null

• Payment event external ID. For ACH transactions, this is the ACH trace number.

• descriptor

• string

• required
  Transaction descriptor

• user_defined_id

• string | null

• User-defined identifier

• expected_release_date

• date | null

• Expected release date for the transaction

• related_account_tokens

• required
  Related account tokens for the transaction

Related Account Tokens

• object
  Required:
• type
• string
• enum
  Allowed:
  ORIGINATION_CRED, ORIGINATION_DEBIT, RECEIPT_CREDIT, RECEIPT_DEBIT, WIRE_INBOUND_PAYMENT, WIRE_INBOUND_ADMIN, WIRE_OUTBOUND_PAYMENT, WIRE_OUTBOUND_ADMIN, WIRE_INBOUND_DRAWDOWN_REQUEST

tags

• object
  Key-value pairs for tagging resources.

Example JSON Output

{
  "status": "PENDING",
  "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "created": "2026-07-18T00:26:07.920Z",
  "updated": "2026-07-18T00:26:07.920Z",
  "family": "string",
  "category": "ACH",
  "currency": "USD",
  "result": "APPROVED",
  "method_attributes": {
    "sec_code": "CCD",
    "return_reason_code": "string",
    "ach_hold_period": 0,
    "retries": 0,
    "company_id": "string",
    "receipt_routing_number": "string",
    "trace_numbers": [
      "string"
    ],
    "addenda": "string",
    "override_company_name": "string"
  },
  "financial_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "external_bank_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "direction": "CREDIT",
  "source": "LITHIC",
  "method": "ACH_NEXT_DAY",
  "settled_amount": 500,
  "pending_amount": 200,
  "events": [
    {
      "amount": 0,
      "created": "2026-07-18T00:26:07.920Z",
      "detailed_results": [
        "APPROVED"
      ],
      "result": "APPROVED",
      "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "type": "ACH_ORIGINATION_CANCELLED",
      "external_id": "string"
    }
  ],
  "descriptor": "string",
  "user_defined_id": "string",
  "expected_release_date": "2026-07-18",
  "related_account_tokens": {
    "business_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  },
  "type": "ORIGINATION_CREDIT",
  "tags": {
    "risk-level": "high"
  },
  "event_type": "payment_transaction.updated"
}