> ## Documentation Index
> Fetch the complete documentation index at: https://memberpulseptyltd.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Invoices

> View and download your invoices and payment history

View your payment history and download invoices.

## Invoice List

View all invoices with:

* Invoice number
* Date
* Amount
* Status (paid, pending, overdue)
* Related item (membership, event, course, sponsorship)

## Invoice Actions

* **View** - See invoice details
* **Download PDF** - Download invoice/receipt
* **Pay** - Pay outstanding invoices

## Payment History

View all transactions:

* Payment date
* Amount
* Payment method
* Receipt download

## UI Spec (from supplied spreadsheet)

The spreadsheet’s payment/order primitives live in `workspace/sources/entity-registry.csv` ("Order" / payment fields) and are represented in Entities via the transaction record.

Common invoice/payment fields:

| Field                     | Notes                                                                    |
| ------------------------- | ------------------------------------------------------------------------ |
| Total / Total Amount      | Total payable amount (incl tax where configured)                         |
| Currency                  | e.g. AUD                                                                 |
| Reference Id              | Gateway/reference identifier                                             |
| Status                    | Pending, Paid, Failed (plus refund states when implemented)              |
| Order Type / Related Type | Membership, Event, Course, Resource, Corporate Subscription, Sponsorship |

#### Data Model Cross‑Reference (Entities)

* Invoices, payments, receipts, refunds: [`Payment Transaction`](/entities/integration/payment-transaction)

## Features

### Invoices

#### Acceptance Criteria

##### Frontend

* [ ] UI supports the workflows described in this feature.

##### Backend / API

* [ ] Backend behavior supports this feature as documented.

##### Permissions

* [ ] Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

##### Business Rules

* [ ] All business rules for this feature are enforced.

##### Error Handling

* [ ] Error states return clear messages and appropriate HTTP status codes.

## Implementation Contracts

### Backend (API)

```
GET    /api/member/invoices                  # List invoices
GET    /api/member/invoices/{id}             # Invoice details
GET    /api/member/invoices/{id}/pdf         # Download PDF
POST   /api/member/invoices/{id}/pay         # Pay invoice

GET    /api/member/payments                  # Payment history
GET    /api/member/payments/{id}/receipt     # Download receipt
```
