Overview

Customers can now isolate how payments that hit an end user account for a given day were waterfalled and applied to the different balance buckets

Details

The data in the payment_only_allocation object is a subset of the payment_allocation. But whereas payment_allocation shows all kinds of credits that affected a financial_account for a given day, payment_only_allocation is only the credits where family == PAYMENT

• The JSON schema is the exact same for payment_only_allocation and payment_allocation (See below)
• Payment application order is the same between the 2 objects
• Since payment_allocation summarizes all credits to the financial_account, it is best used as a tool for reconciliation across the balance buckets
• Since payment_only_allocation summarizes only payments to the financial_account, it can be used as a reporting tool for lenders looking to understand financials for end user payments, and overall program health across the balance buckets

{
  "payment_only_allocation": {
    "interest": 315,
    "principal": 16935,
    "fees": 750,
    "interest_details": {
      "purchases": 150,
      "cash_advances": 90,
      "balance_transfers": 75
    },
    "principal_details": {
      "purchases": 8935,
      "cash_advances": 3000,
      "balance_transfers": 5000
    },
    "fee_details": {
      "purchases": 350,
      "cash_advances": 300,
      "balance_transfers": 100
    }
  }
}

For further details about Payment Allocation, and to run through a full example, please see https://docs.lithic.com/changelog/payment-allocation-details-added-to-loan-tape-api

Release Timeline

Available now: September 30, 2026. Loan Tapes beginning Sept 28, 2025 should have payment_only_allocation details populated

User Impact

No impact, this change is additive only. Learn more about Statements and Loan Tape APIs via our API Reference

If you have any questions or concerns, please contact us via the HELP link in your Lithic Dashboard.

The Lithic changelog has an RSS feed! To monitor for new update announcements, subscribe with your preferred RSS reader.