API successor in flight. The daily receivables sale is moving from this file exchange to a Sale API — a daily sale object with webhooks. The daily cycle is unchanged; this schema is authoritative until the successor is Released.
This file is generated by you and outlines the acceptance or rejection of the Sales Request file.
Lead offers two balance sheet models: Originate-to-Sell (OTS) and On-Sheet Lending (OSL). Under OTS, Lead sells receivables to the partner after the applicable hold period. Under OSL, Lead retains receivables on its own balance sheet through the loan’s terminal status rather than selling them.Sales Response files only contain entries for receivables designated as OTS. If the corresponding Sales Request contains no OTS receivables, the Sales Response will also be empty.
Ensure that the settlement_amount has been sent to the Operating Account prior to responding via Sales Response.
For all optional fields where you do not plan to pass through data, please include the header and an empty value.
Schema
Sandbox Behavior
In the first few days of Sandbox testing where you first begin creating loans, all loans will be within the “hold period” (i.e., still owned by Lead), meaning there will be no loans to be sold from Lead to you.
During this period, Lead’s Sandbox environment generates empty Sales Request Files and posts them to your SFTP folder, beginning on Day 0. This facilitates testing of the end-to-end process. You are expected to send empty Sales Response Files during this period, also beginning on Day 0.
This process continues until the hold period of the first loan(s) that you created ends, and a true “sale” is ready to be made from Lead to you, meaning the Sales Request File is populated with a loan record. If the first loan(s) created is on Day 1, then this typically occurs on Day 4.
For any subsequent days where the Sales Request is empty (e.g., no loans were created in preceding days), you should continue to send empty Sales Response Files to complete the end-to-end Sandbox testing workflow.
For OSL programs, no receivables will ever be designated as OTS, so Sales Request and Sales Response files will always be empty in both Sandbox and Production. This is expected behavior.
