Update invoice status

Manually change an invoice's status, e.g., cancel it if the order is voided.

Endpoint

PATCH /invoices/[invoice_id]

Request Body Parameters

ParameterTypeRequiredDescriptionExample ValueNotes
statusstringYesNew statuscancelledOne of: new, pending, completed, expired, cancelled, paid_partial

cURL Example

curl -X PATCH https://api.itispay.com/api/v1/invoices/123e4567-e89b-12d3-a456-426614174000 \
-H "Api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"status": "cancelled"}'

Response

  • 200 OK: Updated invoice details.
  • Errors: 400 (bad request), 401, 403, 404, 422 (invalid status), 500.