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

# storekit-Zahlungslinks erstellen und teilen

> Erstellen Sie teilbare storekit-Zahlungslinks, um Einmal- oder wiederverwendbare Zahlungen von Kunden einzuziehen. Versand per E-Mail, SMS oder Chat — ohne Bestellung an der Kasse.

Verwenden Sie Zahlungslinks, um Zahlungen außerhalb des Standard-Bestellablaufs einzuziehen. Teilen Sie einen Link per E-Mail oder SMS, und Ihr Kunde zahlt direkt über eine gehostete Checkout-Seite — ohne dass eine Bestellung nötig ist.

## Linktypen

Zahlungslinks gibt es in zwei Ausführungen:

| Typ                  | Beschreibung                                                                                  |
| -------------------- | --------------------------------------------------------------------------------------------- |
| **Einmal**           | Deaktiviert sich automatisch nach einer einzigen erfolgreichen Zahlung                        |
| **Wiederverwendbar** | Bleibt aktiv und nimmt mehrere Zahlungen an (optional bis zu einer konfigurierten Obergrenze) |

## Betragstypen

| Typ          | Beschreibung                                                                                                   |
| ------------ | -------------------------------------------------------------------------------------------------------------- |
| **Fest**     | Ein festgelegter Betrag, den der Kunde bezahlen muss                                                           |
| **Variabel** | Der Kunde gibt den Betrag an der Kasse ein, optional innerhalb eines von Ihnen konfigurierten Min/Max-Bereichs |

## Einen Zahlungslink erstellen

<Info>
  Der Bereich **Zahlungen > Zahlungslinks** ist in Ihrem Dashboard erst sichtbar, nachdem storekit Payments für Ihren Laden aktiviert wurde. Wenn Sie ihn nicht sehen, aktivieren Sie zuerst die Zahlungen über **Ladeneinstellungen > Zahlungen > Zahlungen aktivieren**. Vollständige Einrichtungsanleitung siehe [Zahlungen einrichten](/docs/de/getting-started/launch/set-up-payments).
</Info>

<Steps>
  <Step title="Zahlungslinks öffnen">
    Gehen Sie in Ihrem Dashboard zu **Zahlungen > Zahlungslinks** und klicken Sie auf **Link erstellen**.
  </Step>

  <Step title="Link konfigurieren">
    Füllen Sie die Link-Details aus:

    * **Titel** — dem Kunden an der Kasse angezeigt (erforderlich)
    * **Beschreibung** — optionaler Kontext unter dem Titel
    * **Referenz** — interne Referenz für Ihre Unterlagen (z. B. Rechnungsnummer)
    * **Typ** — einmal oder wiederverwendbar
    * **Betragstyp** — fest oder variabel
    * **Betrag** — erforderlich für feste Links; in der Währung Ihres Ladens angeben
    * **Min-/Max-Betrag** — optionale Grenzen für variable Links
    * **Max. Zahlungen** — optionale Obergrenze für Gesamtzahlungen bei wiederverwendbaren Links
    * **Ablaufdatum** — optionales Datum, ab dem der Link inaktiv wird
    * **Bild** — optionales Bild auf der Checkout-Seite
    * **Kundendaten** — optional Firmenname, Kundenname, E-Mail und Telefonnummer an der Kasse erfassen (siehe [Erfassung von Kundendaten](#erfassung-von-kundendaten))
  </Step>

  <Step title="Verhalten nach der Zahlung konfigurieren">
    Wählen Sie, was nach einer erfolgreichen Zahlung passiert:

    * **Dankeseite** — eine anpassbare Dankesnachricht anzeigen (Standard)
    * **Weiterleitung** — den Kunden zu einer URL Ihrer Wahl senden
  </Step>

  <Step title="Den Link teilen">
    Nach dem Erstellen können Sie die Link-URL kopieren oder die Option **Senden** verwenden, um sie per E-Mail oder SMS zuzustellen.
  </Step>
</Steps>

## Einen Link senden

Sie können einen Zahlungslink direkt aus dem Dashboard senden:

1. Öffnen Sie den Zahlungslink über **Zahlungen > Zahlungslinks**
2. Klicken Sie auf **Senden**
3. Geben Sie die E-Mail-Adresse oder Telefonnummer des Kunden ein
4. Klicken Sie auf **Link senden**

Der Kunde erhält eine Nachricht mit einem direkten Link zur Checkout-Seite.

## Link-Status

| Status         | Beschreibung                                                          |
| -------------- | --------------------------------------------------------------------- |
| **Aktiv**      | Der Link ist live und akzeptiert Zahlungen                            |
| **Inaktiv**    | Der Link wurde manuell deaktiviert oder ein Einmal-Link wurde bezahlt |
| **Abgelaufen** | Das Ablaufdatum des Links ist verstrichen                             |

## Einen Link deaktivieren

Um zu verhindern, dass ein Link weitere Zahlungen annimmt, öffnen Sie ihn über **Zahlungen > Zahlungslinks** und klicken Sie auf **Deaktivieren**. Deaktivierte Links geben allen Besuchern eine Nachricht „nicht mehr aktiv" zurück.

## Erfassung von Kundendaten

Sie können einen Zahlungslink so konfigurieren, dass Kundendaten an der Kasse erfasst werden. Jedes Feld kann unabhängig auf einen von drei Modi gesetzt werden:

| Modus      | Beschreibung                                                               |
| ---------- | -------------------------------------------------------------------------- |
| `disabled` | Das Feld wird an der Kasse nicht angezeigt (Standard)                      |
| `optional` | Das Feld wird angezeigt, ist aber nicht erforderlich                       |
| `required` | Das Feld muss ausgefüllt werden, bevor die Zahlung fortgesetzt werden kann |

Die verfügbaren Felder sind:

* **Firmenname** — die Firma oder der Handelsname des Kunden
* **Kundenname** — der vollständige Name des Kunden
* **E-Mail** — die E-Mail-Adresse des Kunden
* **Telefon** — die Telefonnummer des Kunden

Erfasste Daten werden zu jedem Zahlungsdatensatz gespeichert und sind im Tab **Transaktionen** sichtbar.

## QR-Codes

Jeder Zahlungslink verfügt über einen QR-Code, der die Checkout-URL kodiert. Sie können den QR-Code als PNG-Bild von der Detailseite des Zahlungslinks herunterladen oder ihn über die API oder das MCP-Tool `get-payment-link-qr` erzeugen.

Der QR-Code eignet sich zum Aufdrucken auf Rechnungen, Belegen oder Aushängen, damit Kunden ihn scannen und direkt bezahlen können.

## Rückerstattungen

Für jede über einen Zahlungslink eingezogene Zahlung können Sie eine Rückerstattung ausstellen:

1. Öffnen Sie den Zahlungslink über **Zahlungen > Zahlungslinks**
2. Wechseln Sie zum Tab **Transaktionen**
3. Wählen Sie die zu erstattende Zahlung aus
4. Klicken Sie auf **Erstatten** und geben Sie den Betrag ein

Teil-Rückerstattungen werden unterstützt. Der Zahlungsstatus wird entsprechend auf **Teilweise erstattet** oder **Vollständig erstattet** aktualisiert.

## Transaktionen einsehen

Jeder Zahlungslink hat einen Tab **Transaktionen**, der alle eingegangenen Zahlungen mit Betrag, Währung, Zahlungsreferenz und erfassten Kundendaten anzeigt.

## Zahlungslink-IDs

Zahlungslinks verwenden eine ID mit dem Präfix `plink_` (zum Beispiel `plink_019dbc4d828174419d9ff9fae24aea7b`). Verwenden Sie diese ID, wenn Sie einen Link über die API oder Webhooks referenzieren.

## Webhook-Ereignisse

storekit löst folgende Webhook-Ereignisse für Zahlungslinks aus:

| Ereignis                        | Beschreibung                                                                     |
| ------------------------------- | -------------------------------------------------------------------------------- |
| `payment_link.created`          | Ausgelöst, wenn ein neuer Zahlungslink erstellt wird                             |
| `payment_link.paid`             | Ausgelöst, wenn eine Zahlung über einen Zahlungslink erfolgreich eingezogen wird |
| `payment_link.refund.created`   | Ausgelöst, wenn eine Rückerstattung für eine Zahlungslink-Zahlung initiiert wird |
| `payment_link.refund.succeeded` | Ausgelöst, wenn das Zahlungs-Gateway den Erfolg einer Rückerstattung bestätigt   |
| `payment_link.refund.failed`    | Ausgelöst, wenn das Zahlungs-Gateway eine Rückerstattung ablehnt                 |

Vollständige Payload-Referenzen finden Sie unter [Webhook-Ereignisse](/docs/de/developers/webhooks/webhook-events).

## API- und MCP-Zugriff

Zahlungslinks stehen über die storekit-API und MCP-Tools zur Verfügung. Sie können:

* Zahlungslinks auflisten (nach Standort, Status oder Typ filtern)
* Einen einzelnen Zahlungslink nach ID abrufen
* Einen neuen Zahlungslink erstellen
* Einen QR-Code für einen Zahlungslink erzeugen (`get-payment-link-qr`)

Weitere Informationen zum API- und MCP-Zugriff finden Sie unter [Entwicklereinführung](/docs/de/developers/introduction).


## Related topics

- [Ihre storekit-Store-URL finden und teilen](/docs/de/guides/store-settings/store-url.md)
- [Trinkgeld und Servicegebühren](/docs/de/guides/payments/tips-service-charges.md)
- [Rückerstattungen und Auszahlungen](/docs/de/guides/payments/refunds-payouts.md)
- [1. Store erstellen](/docs/de/getting-started/launch/create-your-store.md)
- [Bar- und Zahlung-bei-Abholung-Bestellungen](/docs/de/guides/payments/cash-payments.md)