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

# Payment Links Referenz

> Referenz für storekit Payment Links: Link-Typen, Preismodi, Status, Transaktionsstatus, Erstellungsfelder, Kundenfeld-Modi, IDs, MCP-Tools und Webhook-Events.

Schnelle Nachschlagreferenz für die Begriffe aus den Payment-Links-Guides. Für Anleitungen folgen Sie den Links in jedem Abschnitt.

## Link-Typen

| Dashboard-Label | Verhalten | API-Wert |
| - | - | - |
| **One-off** | Schließt nach einer erfolgreichen Zahlung | `one_off` |
| **Reusable** | Bleibt offen, bis deaktiviert, abgelaufen oder das Zahlungslimit erreicht ist | `reusable` |

Beim Erstellen festgelegt.

## Preismodi

| Dashboard-Label | Verhalten | API-Wert |
| - | - | - |
| **Set price** | Kunde zahlt den **Price**, den Sie eingeben | `fixed` |
| **Customer chooses** | Kunde gibt einen Betrag ein, optional innerhalb von **Minimum** und **Maximum** | `variable` |

Beim Erstellen festgelegt. **Minimum** und **Maximum** können danach bearbeitet werden.

## Link-Status

| Status | Wie ein Link dorthin gelangt | Kann er geändert werden? |
| - | - | - |
| **Active** | Erstellt oder mit **Activate** reaktiviert | **Deactivate** |
| **Inactive** | **Deactivate** | **Activate** |
| **Expired** | **Link expiry date** ist erreicht | Nein — einen neuen Link erstellen |
| **Completed** | One-off-Link bezahlt, oder Reusable-Link hat **Maximum number of payments** erreicht | Nein — einen neuen Link erstellen |

Details in [Payment Links verwalten](/docs/de/payment-links/managing-payment-links#status).

## Transaktionsstatus

| Status | Bedeutung | Erstattbar? |
| - | - | - |
| **Pending** | Zahlung gestartet, noch nicht bestätigt | Nein |
| **Paid** | Zahlung erfolgreich | Ja |
| **Partial Refund** | Ein Teil der Zahlung erstattet | Ja, bis zu **Max refundable** |
| **Refunded** | Vollständig erstattet | Nein |

Details in [Rückerstattungen und Transaktionen](/docs/de/payment-links/refunds-and-transactions).

## Erstellungsfelder

Labels wie auf der Seite **New Payment Link** gezeigt. Die Detailseite verwendet kürzere Labels für dieselben Felder, in Klammern angegeben, wo sie sich unterscheiden.

| Feld | Erforderlich | Später bearbeitbar |
| - | - | - |
| **Store** | Ja | Nein |
| **Title** | Ja | Ja |
| **Description shown to the customer** (**Description**) | Nein | Ja |
| **Link type** (**Link Type**) | Ja | Nein |
| **Pricing** (**Amount Type**) | Ja | Nein |
| **Price** | Bei **Set price** | Nein |
| **Minimum** / **Maximum** (**Min Amount** / **Max Amount**) | Nein | Ja |
| **Image** | Nein | Ja |
| **Customer fields** — **Name**, **Email**, **Phone**, **Business name** | Nein | Ja |
| **Reference** | Nein | Ja |
| **Link expiry date** (**Expiry Date**) | Nein | Ja |
| **Maximum number of payments** (**Max Payments**) | Nein, nur Reusable | Ja |
| **After successful payment** (**After Payment**) | Ja, Standard **Show thank you** | Ja |
| **Custom thank you message** (**Success Message**) | Nein | Ja |
| **Redirect URL after payment** (**Redirect URL**) | Bei **Redirect to URL** | Ja |

### Kundenfeld-Modi

| Dashboard-Label | Verhalten auf der Checkout-Seite | API-Wert |
| - | - | - |
| **Off** | Feld wird nicht angezeigt | `disabled` |
| **Optional** | Angezeigt, mit *optional* gekennzeichnet | `optional` |
| **Required** | Angezeigt, muss zum Bezahlen ausgefüllt werden | `required` |

Die vier Felder werden auf `collectCustomerName`, `collectEmail`, `collectPhone` und `collectBusinessName` abgebildet.

## Woher Links kommen

Die Detailseite zeigt für jeden Link **Created via**:

| Wert | Erstellt von |
| - | - |
| `dashboard` | **Payment Links** → **Create Payment Link** |
| `order` | Die **Send Payment Link**-Aufforderung auf einer Bestellung — siehe [Zahlung für eine unbezahlte Bestellung einziehen](/docs/de/payment-links/collecting-for-an-order) |
| `mcp` | Ein KI-Assistent, verbunden über storekit MCP |
| `api` | Direkte API-Integration |

## Payment-Link-IDs

Jeder Payment Link hat eine ID mit dem Präfix `plink_`, zum Beispiel `plink_019dbc4d828174419d9ff9fae24aea7b`. Sie erscheint in der Dashboard-URL, wenn der Link offen ist, in MCP-Tool-Antworten und in Webhook-Payloads und ist der letzte Teil der kundenseitigen URL: `https://<Ihre Bestell-Domain>/pay/plink_…`.

## Entwickler

### MCP-Tools

Verbundene KI-Assistenten nutzen diese Tools. Parameter siehe [MCP-Tools](/docs/de/developers/mcp/tools).

| Tool | Typ |
| - | - |
| `list-payment-links` | Read |
| `get-payment-link` | Read |
| `create-payment-link` | Write — der Assistent fragt nach Freigabe, sofern Sie ihn nicht auf Auto-Freigabe gesetzt haben |
| `get-payment-link-qr` | Read — gibt ein PNG zurück |

### Webhook-Events

| Event | Ausgelöst, wenn |
| - | - |
| `payment_link.created` | Ein Payment Link erstellt wird |
| `payment_link.paid` | Eine Zahlung über einen Link eingezogen wird |
| `payment_link.refund.created` | Eine Rückerstattung angefragt wird |
| `payment_link.refund.succeeded` | Das Zahlungs-Gateway die Rückerstattung bestätigt |
| `payment_link.refund.failed` | Das Zahlungs-Gateway die Rückerstattung ablehnt |

Payloads sind unter [Webhook-Events](/docs/de/developers/webhooks/webhook-events#payments-events) dokumentiert.


## Related topics

- [Payment Links verwalten](/docs/de/payment-links/managing-payment-links.md)
- [Payment-Link-Rückerstattungen und -Transaktionen](/docs/de/payment-links/refunds-and-transactions.md)
- [Einen Payment Link erstellen](/docs/de/payment-links/creating-a-payment-link.md)
- [Webhook-Events](/docs/de/developers/webhooks/webhook-events.md)
- [Was Sie fragen können](/docs/de/guides/ai/what-you-can-ask.md)


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