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

> Verfolge jeden Zahlungslink, den du erstellt hast, sieh, was bezahlt wurde, und deaktiviere die, die nicht mehr aktiv sein sollen.

Sieh jeden Link, den du geteilt hast, was er eingebracht hat, und schalte die ab, mit denen du fertig bist.

> [!NOTE]
>
> **Nur im Web.** Zahlungslinks werden im Moove Widget erstellt und unter [moove.xyz/dashboard/payment-link](https://www.moove.xyz/dashboard/payment-link) verwaltet. Die Moove App hat keinen Zahlungslink-Bildschirm — ihr Bildschirm **Empfangen** teilt stattdessen deinen Handle und deinen QR-Code.

## Welche drei Status gibt es?

| Status | Bedeutung | Nimmt Zahlungen an |
| - | - | - |
| **Aktiv** | Aktiv und geteilt | Ja |
| **Abgeschlossen** | Vollständig bezahlt oder Nutzungslimit erreicht | Nein |
| **Inaktiv** | Von dir deaktiviert oder abgelaufen | Nein |

Filtere die Liste nach Status, um zu sehen, was noch im Umlauf ist.

## Was zeigt jeder Link?

Das Dashboard listet deine Links in einer Tabelle auf. Das sind ihre Spalten:

| Spalte | Was sie zeigt |
| - | - |
| **Erstellt** | Wann du ihn erstellt hast |
| **Link** | Die teilbare URL |
| **Betrag** | Was du verlangst, in deinem Abwicklungs-Token |
| **Status** | Active, Completed oder Inactive |
| **Ablaufdatum** | Wann er keine Zahlungen mehr annimmt, oder **Nie** |
| **Received** | Was tatsächlich darüber bezahlt wurde |
| **Beschreibung** | Was die zahlende Person sieht |
| **Aktion** | **Ansehen**, **Teilen** und **Deaktivieren** |

## Wie deaktiviere ich einen Link?

**1. Manage → Payment Links öffnen**

Im Web-Dashboard.

**2. Den Link finden**

Filtere auf **Aktiv**, wenn die Liste lang ist.

**3. Deaktivieren**

Sein Status wird **Inaktiv**, und er nimmt sofort keine Zahlungen mehr an.

> [!WARNING]
>
> Deaktivieren ist endgültig. Ein inaktiver Link lässt sich nicht wieder aktivieren — erstelle stattdessen einen neuen.
>
> Die URL wird dadurch auch nicht zurückgeholt. Wer den Link hat, behält die URL; sie funktioniert nur nicht mehr. Steht der Link auf einer öffentlichen Seite, nimm ihn dort ebenfalls heraus.

## Einen Link sich selbst schließen lassen

Ein im Moove Widget erstellter Link nimmt **eine Zahlung an und läuft nie ab**. Er ist abgeschlossen, sobald er vollständig bezahlt ist, sodass sich ein Rechnungslink selbst aufräumt.

Über die [API](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md) erstellte Links können zusätzlich zwei Limits setzen:

* **`maxUsage`** — wie viele Zahlungen der Link annimmt, bevor er abgeschlossen ist.
* **`expirationDate`** — wann er keine Zahlungen mehr annimmt. Ein Link nach seinem Ablaufdatum wird **Inaktiv**.

> [!TIP]
>
> Für Rechnungen reicht ein Moove-Widget-Link schon: Er kann nur einmal bezahlt werden. Brauchst du zusätzlich eine Frist, erstelle den Link über die API mit einem `expirationDate`.

## Abgleich mit Moove Transactions

Jede Zahlung über einen Link ist mit der ID dieses Links verknüpft. Die ID steht nicht in der Transaktionstabelle im Web, gleiche dort also über die Beschreibung ab — oder über die Link-ID per API.

[Moove Transactions →](https://docs.moove.xyz/de-de/manage/moove-transactions.md)

## Wie mache ich das im Code?

Die API listet deine Links mit denselben Status und denselben Feldern auf, auch Links, die im Dashboard oder von einem anderen Schlüssel in deinem Konto erstellt wurden — sie ist also der Endpunkt für den Abgleich.

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

> [!NOTE]
>
> Die API kann Links erstellen und lesen. Einen Link zu deaktivieren geht nur im Dashboard.

[Moove Payment Links API →](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md)

## Das solltest du als Nächstes lesen

> [card] [Moove Receive](https://docs.moove.xyz/de-de/transact/moove-receive.md)
>
> Erstelle den nächsten.

> [card] [Moove API Keys](https://docs.moove.xyz/de-de/manage/moove-api-keys.md)
>
> Links per Code erstellen.

> [card] [Moove Transactions](https://docs.moove.xyz/de-de/manage/moove-transactions.md)
>
> Sieh, was bezahlt wurde.

Jeder Link im Blick. Dein Geld. Deine Entscheidung.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.