Skip to content
1 minute readFixedAgent-ready

Invoices, payments, refunds and disputes are checked against each other

Billing records must match their customer, currency and amounts: a sent invoice keeps its amount, partial refunds track what is left, and a dispute cannot exceed its payment.

The API reference for POST /api/payments/{paymentId}/refund, which now refunds a payment in parts up to what is left.
  • Invoices and payments must belong to a customer in the workspace and use the currency's precision.
  • A sent invoice keeps its amount; recorded payments decide whether it is covered.
  • A partial refund records what was refunded and what remains, and can make an invoice outstanding again.
  • A dispute cannot be larger than its payment.

Recording a payment or refund here does not move money.