Get Started

Record a payment against a debt instrument

POST/api/v1/businesses/{business_id}/cfo-portal/debt-schedule/instruments/{instrument_id}/payments

Record a payment on a loan, posting a balanced principal/interest entry.

Request Body:

  • payment_amount_cents: total payment, split into principal + interest.
  • cash_ledger_id: bank/cash account the money moves through.
  • payment_date: optional, defaults to today.
  • memo: optional journal-entry memo.

The principal and interest accounts are resolved by direction: debt we owe pays down Long-Term Debt with Interest Expense; a note receivable collects against Notes Receivable with Interest Income. Decrements the instrument's outstanding balance by the principal portion.

Operation ID: cfo_portal_record_debt_payment_api_v1_businesses__business_id__cfo_portal_debt_schedule_instruments__instrument_id__payments_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

business_idstringrequired
instrument_idstringrequired

Request body

Schema: DebtPaymentRequest

payment_amount_centsintegerrequired

Total payment amount in cents (split into principal + interest).

cash_ledger_idstringrequired

Bank/cash ledger the money moves through — paid from (debt we owe) or received into (a note receivable).

payment_datestring · date

Payment date (defaults to today).

memostring

Responses

201Successful Response

Schema: DebtPaymentResponse

journal_entry_idstringrequired
principal_centsintegerrequired
interest_centsintegerrequired
remaining_balance_centsintegerrequired
namestringrequired
directionstringrequired

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject