Skip to content

Update an invoice status. body { status: "void" } voids an open invoice; body { status: "paid" } marks an open invoice paid. Non-open is rejected 4xx.

PATCH
/v1/invoices/{id}
id
required
string
Idempotency-Key
string

Required on every mutating /v1/* endpoint (Phase 1 fixture relaxes to optional)

object
status
string
Allowed values: void paid
object
success
required
boolean
data
required
object
invoice
required
object
id
required
string
businessId
required
string
subscriptionId
required
string
invoiceNumber
required
string
status
required
string
Allowed values: draft open paid void uncollectible
periodStart
required
string format: date-time
periodEnd
required
string format: date-time
totalAmountPaisa
required
string format: int64
currency
required
string
metadata
required
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
meta
required
object
requestId
required
string