Zum Hauptinhalt springen

Zahlungslinks

Mit Zahlungslinks können Sie Zahlungen auch ohne Backend-System oder E-Commerce-Plattform einziehen. Sie erstellen einen Link in Ihrem Space, teilen die URL oder den QR-Code mit, und der Kunde schließt die Zahlung auf einer gehosteten Zahlungsseite ab.

Es gibt zwei Möglichkeiten, damit zu arbeiten:

  • Konfigurieren Sie alles in Ihrem Space – Währung, Zahlungsmethoden, Gültigkeitsdauer und Betrag sind direkt im Link festgelegt. Teilen Sie einfach die URL oder den QR-Code, und schon sind Sie fertig.
  • Daten aus Ihrem eigenen Formular übergeben — Ein schlankes HTML-Formular auf Ihrer Website liefert Rechnungsadressen, Einzelposten oder Beträge pro Zahlung. Es ist keine serverseitige Logik erforderlich.

Häufige Anwendungsfälle​

  • Statische Produktseiten – zum Beispiel Blitzangebote oder Landingpages
  • Spendenseiten – mit dynamischen oder festen Beträgen
  • Eingebettete Formulare auf Websites ohne Backend-Logik
  • Vereinfachte Zahlungsprozesse für Einzelkäufe
info

Wenn Sie Mahnungen verwalten oder Zahlungslinks automatisch per E-Mail versenden möchten, sollten Sie stattdessen die Verwendung von Charge Flows in Betracht ziehen.

  1. Öffnen Sie Ihre Space-Einstellungen.
  2. Klicken Sie auf Funktionen und aktivieren Sie den Schalter Zahlungslink.
  3. Speichern Sie die Änderungen.
  1. Öffnen Sie die Liste der Zahlungslinks in Ihrem Space.
  2. Klicken Sie auf Zahlungslink erstellen.
  3. Geben Sie einen Namen ein.
  4. Passen Sie die folgenden Optionen an und klicken Sie auf Erstellen.
OptionWas sie steuert
WährungDie Währung, in der die Zahlung eingezogen wird.
SpracheDie Sprache der Zahlungsseite.
SchutzmodusOb für den Zugriff auf den Zahlungslink ein Schlüssel erforderlich ist.
Zulässige ZahlungsmethodenWelche Zahlungsmethoden dem Kunden zur Auswahl stehen.
Gültig von / bisDer Zeitraum, in dem der Link gültig ist.
Maximale Anzahl von TransaktionenWie viele Zahlungen über den Link getätigt werden dürfen.
Verarbeitungsmodus für Rechnungs- und LieferadresseOb Adressen abgefragt, vorausgefüllt oder übersprungen werden.
info

Nur der Name ist obligatorisch – alle anderen Optionen sind optional. Es ist jedoch ratsam, so viele Angaben wie möglich bereits im Link zu machen: Werte, die im Link nicht fest vorgegeben sind, können in der Anfrage angegeben (und somit geändert) werden.

Nachdem Sie den Link erstellt haben, wird Ihnen Folgendes angezeigt:

  1. Eine öffentliche URL, die Sie per E-Mail, über soziale Medien und ähnliche Kanäle weitergeben können.
  2. Ein QR-Code zum Ausdrucken oder zur Verwendung vor Ort.

Parameter aus einem eigenen Formular übergeben​

Anstatt alles im Link festzulegen, können Sie die Zahlungsdaten zusammen mit der Anfrage übermitteln. Zahlungslinks akzeptieren GET- oder POST-Parameter – wir empfehlen POST –, die Rechnungsadressen, Beträge oder Einzelposten enthalten.

Checkliste für die schnelle Einrichtung​

  1. Erstellen Sie einen Zahlungslink unter Space > Zahlungslinks > Erstellen. Geben Sie dem Link einen Namen und legen Sie optional Werte wie Währung oder Einzelposten vorab fest, um Manipulationen zu verhindern.
  2. Den Link einbetten – Verwenden Sie die generierte URL in einem POST-Formular auf Ihrer Website und übergeben Sie bei Bedarf dynamisch zusätzliche Parameter, wie z. B. die Rechnungsadresse.
  3. Sichern und validieren – Vermeiden Sie GET-Anfragen, um Probleme mit der URL-Länge zu verhindern, nutzen Sie die Adressvalidierung für eine bessere Benutzererfahrung und legen Sie so viel wie möglich im Link fest, um die Änderungsmöglichkeiten des Käufers einzuschränken.

Beispiel für ein HTML-Formular​

<form action="<< put here payment link url >>" method="POST">

	<input type="text" name="billingAddress[givenName]" placeholder="Given Name" />
	<input type="text" name="billingAddress[familyName]" placeholder="Family Name" />
	<input type="text" name="billingAddress[street]" placeholder="Street" />
	<input type="text" name="billingAddress[postcode]" placeholder="Postcode" />
	<input type="text" name="billingAddress[city]" placeholder="City Name" />
	<input type="text" name="billingAddress[country]" placeholder="Country Code" />

	<input type="hidden" name="lineItems[0][uniqueId]" value="test" />
	<input type="hidden" name="lineItems[0][sku]" value="test" />
	<input type="hidden" name="lineItems[0][name]" value="Test" />
	<input type="hidden" name="lineItems[0][amountIncludingTax]" value="10.87" />
	<input type="hidden" name="lineItems[0][type]" value="PRODUCT" />
	<input type="hidden" name="lineItems[0][quantity]" value="1" />

	<input type="hidden" name="metaData[additionalData]" value="Further data you want to store along the transaction." />

	<input type="hidden" name="currency" value="CHF" />

	<!-- Further parameters as you need. -->

	<input type="submit" value="Pay" />
</form>
info

Verwenden Sie die POST-Methode, um Längenbeschränkungen zu vermeiden und Parameter sicherer zu verarbeiten.

Parameter​

Zahlungslinks akzeptieren dieselben Parameter, die auch in unserer API zur Transaktionserstellung verwendet werden – siehe Webservice-API. Die Parameter müssen im UTF-8-Format übermittelt werden und dem von HTML-Formularen unterstützten Schlüssel-Wert-Format entsprechen.

Rechnungs- und Lieferadresse​

Verwenden Sie billingAddress[...] und shippingAddress[...], um Folgendes anzugeben:

  • country (ISO 3166-1 Alpha-2, erforderlich)
  • givenName
  • familyName
  • street
  • postcode
  • city

Kundeninformationen​

  • customerEmailAddress — wird zum Versenden von Bestätigungs-E-Mails verwendet.
warnung

customerId wird ignoriert: Es wird für Zahlungslinks nicht unterstützt, ebenso wenig wie Ein-Klick-Zahlungen (siehe unten).

Einzelposten​

Erforderlicher Mindestbetrag pro Posten:

  • lineItems[0][amountIncludingTax]
  • lineItems[0][name]
  • lineItems[0][quantity]
  • lineItems[0][type] – zum Beispiel PRODUCT, SHIPPING oder DISCOUNT
  • lineItems[0][uniqueId]

Zusätzliche Felder wie Steuern, Attribute oder Artikelnummern werden unterstützt.

warnung

Wenn Sie Einzelposten in der Formularanfrage übergeben, anstatt sie im Zahlungslink vorab festzulegen, können diese vom Käufer geändert werden. Das Gleiche gilt für die Händlerreferenz.

Währung​

  • currency – zum Beispiel CHF, EUR oder USD.

Wenn die Währung im Zahlungslink nicht angegeben ist, müssen Sie diese in der Anfrage angeben.

Weiterleitungs-URLs​

  • successUrl – wohin der Kunde nach einer erfolgreichen Zahlung weitergeleitet wird.
  • failedUrl – wohin der Kunde nach einer fehlgeschlagenen Zahlung weitergeleitet wird.
info

Verwenden Sie absolute URLs wie https://example.com/thank-you und keine relativen.

Händler-Referenz​

  • merchantReference — wird in der Transaktionsübersicht angezeigt und für Suchvorgänge verwendet.

Metadaten​

  • metaData[key] = value — speichert zusätzliche Schlüssel-Wert-Daten im Rahmen der Transaktion.

Beispiel:

<input type="hidden" name="metaData[comment]" value="Order from newsletter campaign" />

Verfügbarkeitszeitraum​

  • availableFrom — zum Beispiel 2025-01-01T00:00:00Z
  • availableUntil — zum Beispiel 2025-01-07T23:59:59Z
info

Das Verfügbarkeitsfenster ist nur dann verbindlich, wenn es direkt im Zahlungslink konfiguriert wird; dies gilt nicht, wenn es über das Formular übergeben wird.

Bewährte Verfahren für die Validierung​

  • Nutzen Sie die clientseitige Adressvalidierung, um die Benutzererfahrung zu verbessern und Fehler zu reduzieren.
  • Wir validieren Formulardaten vor der Verarbeitung stets serverseitig.
  • Fehler werden auf einer Fallback-Fehlerseite angezeigt, was für den Benutzerablauf nicht ideal ist – Probleme zunächst im eigenen Formular zu erkennen, sorgt für eine bessere Benutzererfahrung.

Allgemeine Geschäftsbedingungen​

Fügen Sie bei Bedarf ein Kontrollkästchen in Ihr Formular ein, damit der Kunde Ihre Allgemeinen Geschäftsbedingungen bestätigt.

Um eine noch sicherere Garantie zu erhalten, nutzen Sie das Add-on „Allgemeine Geschäftsbedingungen“, das die Zustimmung direkt auf der Zahlungsseite erzwingt.

Warum Ein-Klick-Zahlungen nicht unterstützt werden​

Zahlungslinks unterstützen keine Ein-Klick-Zahlungen, und zwar aus folgenden Gründen:

  • Wir führen keine Authentifizierung der Nutzer durch, und
  • Zahlungsdaten können ohne Authentifizierung nicht sicher wiederverwendet werden.

Selbst wenn „One-Click“ für eine Zahlungsmethode aktiviert ist, wird diese Funktion ignoriert, wenn die Zahlung über einen Zahlungslink erfolgt. Informationen zu den Integrationen, bei denen „One-Click“ verfügbar ist, finden Sie unter „Tokenisierung“.

Verwandte Themen​

  • Zahlungsabläufe – falls Sie automatische Erinnerungen benötigen oder den Link per E-Mail zugeschickt bekommen möchten.
  • Transaktionsstatus – Was passiert, nachdem der Kunde bezahlt hat?
  • Zahlungsintegrationen – Welche weiteren Zahlungsmöglichkeiten stehen dem Kunden zur Verfügung?