Skip to content

invoice_not_prepaid

Raised by POST /admin/invoices/{id}/settle-out-of-band (action billing.invoice.settle_out_of_band) against an invoice whose tenant's in-force subscription_terms.deal_shape is not prepaid. The out-of-band settlement recognizes cash held as a deferred-revenue deposit, and it keys on the in-force terms (ADR-0035 d5): a comped tenant's invoice is offset by a credit note (billing.credit_note.issue), and a paying/catalog tenant's invoice is collected by Stripe. What an operator does: if the tenant should be prepaid, record the prepaid terms row and the deposit first; otherwise this is not the instrument. P1 - built 2026-08-29 (ADR-0035; keyed on TERMS_IN_FORCE_NOW).

Problem shape

Every non-2xx response is an RFC 9457 application/problem+json body. The type URI below is stable and machine-matchable, so branch on the final path segment (the code) and treat the status as redundant confirmation. See the error-handling guide.

{
  "type": "https://docs.vocapable.com/errors/invoice_not_prepaid",
  "title": "…",
  "status": 422,
  "detail": "…",
  "instance": "/v1/…"
}

← Back to the error registry