Eingebetteter Kauf#

Lassen Sie Ihre Nutzer eine NAMES LEGAL-Website erstellen und bezahlen, ohne Ihre Anwendung zu verlassen. Sie fügen eine Codezeile ein; ein Fenster erscheint auf Ihrer Seite, und der gesamte Kaufvorgang findet darin statt.

Ihr Nutzer wird zu einem NAMES LEGAL-Kunden, der direkt von NAMES LEGAL abgerechnet wird. Sie haben nie mit Zahlungen, Kartendaten oder Passwörtern zu tun.

1. Einen Vertriebskanal erhalten#

Bitten Sie das NAMES LEGAL-Team um einen Vertriebskanal. Er enthält:

Einstellung	Zweck
Kennung (`via`)	Ihr technischer Name, zum Beispiel `app-ecole`.
Zugelassene Websites	Die Adressen Ihrer Anwendung, die das Fenster anzeigen dürfen, eine pro Zeile (`https://app.example.com`). Das Fenster weigert sich, anderswo zu erscheinen.
Benachrichtigungsadresse	Optional. Der Endpunkt Ihres Servers, der aufgerufen wird, wenn eine über Sie gekaufte Website bereit ist.
Signaturschlüssel	Wird für Sie generiert. Signiert die Benachrichtigungen.

2. Den Code einfügen#

<script src="https://names.legal/static/embed/names-legal.js"
        data-via="app-ecole"
        data-lang="fr"
        data-email="direction@ecole.ch"
        data-name="École Horizon"
        data-first-name="Awa" data-last-name="Diop"
        data-ref="instance-42"></script>

Das Skript fügt das Fenster an seiner Position ein und passt dessen Höhe automatisch an.

Attribut	Erforderlich	Wirkung
`data-via`	ja	Ihre Kanalkennung.
`data-lang`	nein	Sprache des Fensters: `en`, `fr`, `de`, `it`, `es`, `pt`.
`data-email`, `data-first-name`, `data-last-name`	nein	Konto vorausfüllen.
`data-name`	nein	Name der Organisation; wird auch verwendet, um den Website-Namen vorzuschlagen.
`data-site`	nein	Vorgeschlagener Website-Name (`ecolehorizon` → `ecolehorizon.names.legal`).
`data-ref`	nein	Ihre Kennung für diesen Nutzer. Sie wird Ihnen zurückgegeben, sobald die Website bereit ist.
`data-plan`	nein	Standardmäßig ausgewählter Plan.

Bevorzugen Sie ein einfaches Fenster? Das funktioniert auch:

<iframe src="https://names.legal/embed/app-ecole/?lang=fr&ref=instance-42"
        style="width:100%;max-width:640px;height:1100px;border:0"></iframe>

3. Was Ihr Nutzer sieht#

Plan: monatlich oder jährlich, optionale Add-ons.
Ihre Website: Name (Verfügbarkeit wird während der Eingabe geprüft) und Sprachen.
Ihr Konto: Benutzername und Passwort für ihre Konsole.
Zahlung: Ein sicheres Zahlungsfenster öffnet sich über Ihrer Seite. Die Zahlung befindet sich bewusst nicht im Fenster: Manche Zahlungsmethoden benötigen die gesamte Seite, und der Zahlungsanbieter rät davon ab, seinen Checkout in Fenstern zu verschachteln.
Website bereit: Das Fenster meldet dies und bietet an, die Konsole zu öffnen.

Das Fenster benötigt keine Drittanbieter-Cookies und funktioniert daher in Safari und in Browsern, die diese blockieren.

4. Erfahren, wann die Website bereit ist#

Auf der Seite, ohne Server:

document.addEventListener("names-legal:ready", function (event) {
  console.log(event.detail.site_url, event.detail.console_url, event.detail.reference);
});

Auf Ihrem Server, falls Sie eine Benachrichtigungsadresse angegeben haben, erhalten Sie ein signiertes site.ready-Ereignis. Siehe Webhooks.

Sicherheit#

Das Fenster wird nur auf den für Ihren Kanal deklarierten Adressen angezeigt (Content-Security-Policy: frame-ancestors).
Sie sehen niemals das Passwort oder die Zahlungsdaten des Nutzers.
Das Kaufformular ist gegen automatisierte Übermittlungen geschützt und ratenbegrenzt.