Payment Links Referenz

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.

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.

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

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

​Link-Typen

​Preismodi

​Link-Status

​Transaktionsstatus

​Erstellungsfelder

​Kundenfeld-Modi

​Woher Links kommen

​Payment-Link-IDs

​Entwickler

​MCP-Tools

​Webhook-Events