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

# Moove Payment Links

> Track every payment link you have created, see what has been paid, and deactivate the ones you no longer want live.

See every link you have shared, what it has taken, and shut down the ones you are done with.

<Info>
  **Web only.** Payment links are created in the Moove Widget and managed at [moove.xyz/dashboard/payment-link](https://www.moove.xyz/dashboard/payment-link). The Moove App has no payment-link screen — its **Receive** screen shares your handle and QR code instead.
</Info>

## What Are The Three Statuses?

| Status        | Meaning                                  | Accepts payment |
| ------------- | ---------------------------------------- | --------------- |
| **Active**    | Live and shared                          | Yes             |
| **Completed** | Paid in full, or reached its usage limit | No              |
| **Inactive**  | You deactivated it, or it expired        | No              |

Filter the list by status to see what is still out there.

## What Does Each Link Show?

The dashboard lists your links in one table. These are its columns:

| Column          | What it shows                                     |
| --------------- | ------------------------------------------------- |
| **Created**     | When you made it                                  |
| **Link**        | The shareable URL                                 |
| **Amount**      | What you are asking for, in your settlement token |
| **Status**      | Active, Completed or Inactive                     |
| **Expiry Date** | When it stops accepting payments, or **Never**    |
| **Received**    | What has actually been paid against it            |
| **Description** | What the payer sees                               |
| **Action**      | **View**, **Share** and **Deactivate**            |

## How Do I Deactivate A Link?

<Steps>
  <Step title="Open Manage → Payment Links">
    On the web dashboard.
  </Step>

  <Step title="Find the link">
    Filter to **Active** if the list is long.
  </Step>

  <Step title="Deactivate it">
    Its status becomes **inactive** and it stops accepting payments immediately.
  </Step>
</Steps>

<Warning>
  Deactivating is one-way. An inactive link cannot be reactivated — create a new one instead.

  It also does not un-send the URL. Anyone holding the link keeps the URL; it simply stops working. If the link is on a public page, take it down there too.
</Warning>

## Letting A Link Close Itself

A link created in the Moove Widget accepts **one payment and never expires**. It completes as soon as it is paid in full, so an invoice link cleans itself up.

Links created through the [API](/api-reference/moove-receive/moove-payment-links) can also set two limits:

* **`maxUsage`** — how many payments the link accepts before it completes.
* **`expirationDate`** — when it stops accepting payments. A link past its expiry goes **Inactive**.

<Tip>
  For invoices, a Moove Widget link already does the job: it can only be paid once. If you need a deadline too, create the link through the API with an `expirationDate`.
</Tip>

## Reconciling Against Moove Transactions

Every payment made through a link is tied to that link's id. The id is not shown in the web Transactions table, so match there on the description — or on the link id through the API.

[Moove Transactions →](/manage/moove-transactions)

## How Do I Do It In Code?

The API lists your links with the same statuses and the same fields, including links created from the dashboard or by another key on your account — so it is the endpoint to reconcile against.

```bash theme={null}
curl -sS "https://api.moove.xyz/v1/payment-link?status=active" \
  -H "X-API-Key: $MOOVE_API_KEY"
```

<Note>
  The API can create and read links. Deactivating a link is a dashboard action.
</Note>

[Moove Payment Links API →](/api-reference/moove-receive/moove-payment-links)

## What To Read Next

<CardGroup cols={3}>
  <Card title="Moove Receive" icon="hand-coins" href="/transact/moove-receive">
    Create the next one.
  </Card>

  <Card title="Moove API Keys" icon="key" href="/manage/moove-api-keys">
    Create links in code.
  </Card>

  <Card title="Moove Transactions" icon="list" href="/manage/moove-transactions">
    See what was paid.
  </Card>
</CardGroup>

Every link accounted for. Your Money. Your Move.