## 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
```json
{
  "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"
}
```