Invoice Management
Update Invoice
PUT/invoices/{invoiceNumber}

Use this API to update an open (`DRAFT` or `PENDING`) invoice. Send at least one of `customer_id`, `amount` or `invoice_url`; `store_id`/`tpn` only select the store. - A new `invoice_url` must be PDF, PNG or JPG/JPEG (detected from the file content, not the extension). DOC, DOCX, XLSX, XML and other types are rejected. - Not allowed once the invoice is `SUCCESS`, or while it has an active payment link. - Once a payment (transaction) is linked to an invoice, `amount` and `customer_id` can no longer change

Path Parameters

invoiceNumber*
string

Header Parameters

token*
string

Body Parameters

customer_id
string
amount
number
invoice_url
string
PUT/invoices/{invoiceNumber}
1curl --location --request PUT 'https://api.ipospays.tech/invoice-service/v1/invoices/26108183628R5ajhCRJqc' \
2--header 'token: ' \
3--header 'Content-Type: application/json' \
4--data '{
5 "customer_id": "",
6 "amount": 3000,
7 "invoice_url": ""
8}'
Response

// Awaiting response…

Sample response
{
  "data": {
    "invoice_number": "26108183628R5ajhCRJqc",
    "customer_id": "OGS1AN68JFR6H54",
    "amount": 3000,
    "status": "DRAFT",
    "store_id": "05cbaac8502f",
    "tpn": "247525547632",
    "invoice_url": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
    "payment_link_status": "NONE"
  },
  "message": "Invoice updated successfully",
  "response_code": "SUCCESS",
  "status_code": 200,
  "request_id": "TEST-20261008183720-5FU7ZV",
  "timestamp": "2026-10-08T13:07:20.827Z"
}