Edit a payment on a case

PUT 
/cases/:id/payments/:paymentId

Edits an existing payment on a collection case. Mirrors the payout-split semantics of the create-payment endpoint.

Payout Split: supply both PayoutCreditor and PayoutCollectionPartner to set the split explicitly (they must sum to PaymentAmount), or omit both to have it recomputed from the case's pricing terms.

Invoiced payments are frozen: a payment whose payout has already been invoiced (Stripe/QBO) cannot be edited and returns 422 Unprocessable Entity. This protects the issued accounting entry from silent drift.

Reopen consent: if the edit lowers the payment so a previously closed (Paid) case is left with a positive outstanding balance, the case must be reopened. By default this returns 409 Conflict; resend with reopenCaseIfNeeded: true to confirm — the case is reopened to Active and a case.updated webhook fires.

Request

Responses

200

Payment updated successfully

400

Invalid request (validation errors)

404

Case or payment not found / not assigned to you

409

Edit would reopen the case; resend with reopenCaseIfNeeded=true

422

Payment has already been invoiced and cannot be edited

500

Server error occurred