> ## 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.

# Payments

> Manage payment methods and view transaction history

Manage your saved payment methods and view transaction history.

## Saved Payment Methods

View and manage cards:

* Card type and last 4 digits
* Expiry date
* Default payment method

## Add Payment Method

Add new card via secure Stripe form:

* Card number
* Expiry date
* CVC
* Save for future use

## Transaction History

View all transactions:

* Date
* Description
* Amount
* Status
* Receipt download

## UI Spec (from supplied spreadsheet)

The spreadsheet defines payment/order fields (total, currency, reference, status, order type) which are recorded in the transaction entity.

| Field                     | Notes                                                       |
| ------------------------- | ----------------------------------------------------------- |
| Total / Total Amount      | Amount charged                                              |
| Currency                  | e.g. AUD                                                    |
| Reference Id              | Stripe/gateway reference                                    |
| Status                    | Pending, Paid, Failed (plus refund states when implemented) |
| Order Type / Related Type | Membership, Event, Course, Resource, Corporate Subscription |

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

* Payment gateway transactions, invoices, receipts: [`Payment Transaction`](/entities/integration/payment-transaction)

## Features

### Payments

#### 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/payment-methods           # List saved methods
POST   /api/member/payment-methods           # Add method
DELETE /api/member/payment-methods/{id}      # Remove method
PUT    /api/member/payment-methods/{id}/default # Set default

GET    /api/member/transactions              # Transaction history
GET    /api/member/transactions/{id}/receipt # Download receipt
```