Mit einem Checkout Link kannst du einen vorkonfigurierten Warenkorb fĂĽr ein Produkt erstellen und an deine Kunden senden. Der Kunde kann dann direkt zur Kasse gehen und den Kauf abschlieĂźen.

1

Produkt auswählen

Wähle das Produkt in deinem Produkt-Katalog aus, erstelle einen Preis wenn noch nicht geschehen, und klicke auf den Button “Checkout Link erstellen”.

2

Nach Bestellabschluss einrichten

Wähle unter “Nach Abschluss” eines der Optionen aus, um festzulegen, was nach dem Kauf passieren soll.

  • Standard-Bestätigungsseite: Der Kunde wird auf die Standard-Bestätigungsseite weitergeleitet, und erhält eine Ăśbersicht ĂĽber seine Bestellung und die dazugehörige Rechnung.
  • Benutzerdefinierte Weiterleitung: Der Kunde wird auf eine von dir festgelegte URL weitergeleitet.
  • Benutzerdefinierte Bestätigungsnachricht: Der Kunde wird auf die Standard-Bestätigungsseite weitergeleitet, und erhält eine von dir festgelegte Bestätigungsnachricht angezeigt.

Bei der Verwendung einer benutzerdefinierten Weiterleitung kannst du die URL mit Platzhaltern versehen, die durch URL Parameter ersetzt werden. Weiteres findest du unter Metadaten hinzufĂĽgen.

Zurück zum Anbieter-Button anzeigen: Aktiviere diese Option, wenn du möchtest, dass der Kunde nach dem Kauf auf der Standard-Bestätigungsseite einen Button sieht, um zurück zu deinem Anbieter zu gelangen.

​
Rabattcodes erlauben

Unter “Weitere Optionen” kannst du festlegen, ob der Kunde einen Rabattcode eingeben kann. Aktiviere diese Option, wenn du möchtest, dass der Kunde einen Rabattcode eingeben kann. Andernfalls wird das Feld ausgeblendet.

​
Testzeitraum festlegen

Unter “Weitere Optionen” kannst du für wiederkehrende Produkte festlegen, ob ein Testzeitraum für das Produkt gelten soll.

Aktiviere diese Option, wenn du möchtest, dass der Kunde das Produkt vor dem Kauf testen kann. Der Betrag wird erst nach Ablauf des Testzeitraums fällig.

Wenn im Preis der Testzeitraum ĂĽber Testphase erlauben ausgeschlossen ist, wird diese Option ignoriert.

​
Laufzeiten festlegen

Unter “Weitere Optionen” kannst du für wiederkehrende Produkte festlegen, welche Vertrags- & Kündigungszeiträume für das Produkt gelten. Die Laufzeiten werden anschließend in das Abonnement überführt.

FĂĽr einmalige Produkte ist diese Option ohne Bedeutung.

Solltest du keine Laufzeiten festlegen, wird als Vertragslaufzeit die Abrechnungsperiode verwendet und als KĂĽndigungsfrist 1 Tag.

​
Unternehmensangabe erzwingen

Unter “Weitere Optionen” kannst du festlegen, ob der Kunde verpflichtet ist, eine Unternehmensangabe zu machen. So kannst du sicherstellen, dass du nur an Unternehmen verkaufst.

Hierfür aktiviere die Option “Unternehmensangabe erzwingen”.

​
Menge veränderbar machen

Unter “Weitere Optionen” kannst du festlegen, ob der Kunde die Menge des Produkts im Warenkorb nachträglich verändern kann.

Aktiviere diese Option, indem du die Checkbox “Menge veränderbar” aktivierst. Hiermit kann ein Produkt nicht aus dem Warenkorb entfernt werden, sondern nur die Menge verändert werden.

​
Metadaten hinzufĂĽgen

Du kannst Metadaten an den Checkout Link anhängen, um zusätzliche Informationen zu übergeben.

Diese Metadaten werden:

  • als Weiterleitungsparameter an die benutzerdefinierte Weiterleitung angehängt
  • als Platzhalter in der benutzerdefinierten Weiterleitung ersetzt
  • im Webhook als metadata-Feld ĂĽbergeben

​
Metadaten anhängen

Um Metadaten an den Checkout Link anzuhängen, füge sie als URL-Parameter hinzu, z.B. https://fynn.coreapi.io/checkout-link/xxxxxxxx?metadata[key]=value&metadata[key2]=value2.

Es ist zudem möglich ein mehrdimensionales Array zu übergeben, indem du den Schlüssel mit eckigen Klammern umschließt, z.B. metadata[key][subkey]=value.

​
Platzhalter in der benutzerdefinierten Weiterleitung

Du kannst Platzhalter in der benutzerdefinierten Weiterleitung verwenden, die durch Metadaten ersetzt werden. Um ein angegebenes Metadatum in der benutzerdefinierten Weiterleitung zu verwenden, fĂĽge es in geschweiften Klammern hinzu, z.B. {{metadataKey}}.

Wenn du eine Mandanten-fähige Anwendung betreibst, und bspw. bei Weiterleitung auf eine benutzerdefinierte URL des Mandanten weiterleiten möchtest, kannst du die Mandanten-ID als Metadatum an den Checkout Link anhängen und als Platzhalter in der benutzerdefinierten Weiterleitung verwenden.

Beispiel URL: https://{{mandantId}}.example.com/checkout-success

Beispiel Checkout-URL: https://fynn.coreapi.io/checkout-link/xxxxxx?metadata[mandantId]=acmegmbh

​
Webhooks

Die Metadaten werden im Webhook als metadata-Feld ĂĽbergeben.

{
    "metadata": {
        "key": "value",
        "key2": "value2"
    }
}

​
Checkout Session erstellen

Standardmäßig wird bei Verwendung des Checkout Links eine neue Checkout Session erstellt. Es kann jedoch sinnvoll sein, dass nur eine Checkout Session erstellt wird, wenn du:

  • mehrere Produkte in einem Warenkorb bĂĽndeln möchtest
  • den Checkout Link mehrfach verwenden möchtest

Um eine Checkout Session zu erstellen, fĂĽge den Parameter session=true hinzu, z.B. https://my-tenant.coreapi.io/checkout-link/xxxxxxxx?session=true.

Wenn eine Checkout Session erstellt wurde und ein Checkout Link ohne session=true aufgerufen wird, wird eine einmalige unabhängige Checkout Session erstellt.

Die Checkout Session ist 24 Stunden gĂĽltig. Nach Ablauf dieser Zeit wird der Warenkorb geleert.

​
Checkout Session abrufen

Um die Checkout Session abzurufen, ohne ein weiteres Produkt hinzuzufĂĽgen, rufe folgende API-Route auf: https://[tenant-username].coreapi.io/public/checkout/cart/current. Ersetze [tenant-username] durch deinen Tenant-Namen.

AnschlieĂźend wird zur aktuellen Checkout Session weitergeleitet.

Was this page helpful?

AngeboteĂśbersicht