# Payment History

The Payment History page shows all payment links and POS payments with filtering, sorting, and export capabilities.

You can also fetch this list programmatically — see [API Reference: List Payments](/developers/api-reference.md#list-payments).

## Date Filter

Filter payments by time range using preset buttons or a custom date range:

| Preset | Range                                    |
| ------ | ---------------------------------------- |
| 1D     | Last 24 hours                            |
| 7D     | Last 7 days (default)                    |
| 1M     | Last 30 days                             |
| 1Y     | Last 365 days                            |
| All    | No date restriction                      |
| Custom | Pick start and end dates with a calendar |

The date filter is applied server-side for performance. Custom date ranges use a calendar popup where you select a start date, then an end date.

## Status Checkbox

Check **"Show only completed & partial"** to filter the table to only show:

* **Completed** -- fully paid and settled payments
* **Partial** -- partial payments that were manually withdrawn by the merchant

This is useful for viewing finalized revenue without pending, expired, or failed payments.

## Search

Use the search bar to find payments by order ID, description, payment address, or merchant address. Search works across all payments regardless of the date filter.

## Sorting

Click any column header to sort by that column. Click again to toggle between ascending and descending order. Available sortable columns: Description, Order ID, Amount, Received, Status, Fees, Date.

## Downloading Payments

Click the **Download** button to export the current filtered view.

### Steps

1. Click the **Download** button (next to the search bar)
2. Choose a format: **Excel** (.xlsx) or **PDF** (.pdf)
3. Select which columns to include using the checkboxes
4. Click **Download**

### Export Details

| Feature     | Excel                            | PDF                              |
| ----------- | -------------------------------- | -------------------------------- |
| Format      | .xlsx spreadsheet                | .pdf document                    |
| Branding    | Plain headers                    | Makapay header with report title |
| Date format | YYYY-MM-DD HH:mm:ss              | YYYY-MM-DD HH:mm:ss              |
| File name   | makapay-payments-YYYY-MM-DD.xlsx | makapay-payments-YYYY-MM-DD.pdf  |

### Available Columns

Description, Order ID, Pay Address, Amount, Token, Received, Status, Fees, Date

All columns are selected by default. At least one column must remain selected.

## POS Activity Page

The POS Activity page (**Dashboard > POS > Activity**) uses the same date filter component for consistency. It also has additional filters for Cashier, Terminal, and Status.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.makapay.io/features/payment-history.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.