Invoices & Finance

Invoice management handles payment requests between sellers and the platform.

List Invoices

GET/invoices🔒 Session — can viewAny

Paginated list of invoices. Admins with system access can view all accounts.

Admins with accessToAllAccountsData see invoices across all accounts. Other users see only their own account's invoices.

Show Invoice

GET/invoices/{item}/show🔒 Session — can view

View invoice details.

Create Payment Request

POST/invoices/create/request🔒 Session

Submit a new payment/withdrawal request.

Field	Type	Required	Description
amount	number	Yes	Request amount (min 1, subject to balance validation)
payment_method	string	Yes	Payment method (enum value)

INFO

The requested amount is validated against the user's available balance.

Mark Invoice as Paid

PATCH/invoices/{item}/paid/request🔒 Session — can paid

Mark an invoice as paid (Admin action). Requires proof of payment.

Field	Type	Required	Description
file	file	Yes	Payment proof file
comment	string	No	Payment notes

Mark Invoice as Unpaid

PATCH/invoices/{item}/un-paid/request🔒 Session

Mark an invoice as unpaid.

Cancel Invoice

PATCH/invoices/{item}/cancel/request🔒 Session — can cancel

Cancel an invoice request. Rolls back associated balance changes.

Delete Invoices (Bulk)

DELETE/invoices/delete🔒 Session — can delete

Bulk delete invoices.

Field	Type	Required	Description
ids	array	Yes	Array of invoice IDs