Acquisto integrato#

Consenta ai Suoi utenti di creare e pagare un sito NAMES LEGAL senza uscire dalla Sua applicazione. Lei incolla una riga di codice; nella Sua pagina appare un riquadro e l'intero acquisto avviene al suo interno.

Il Suo utente diventa un cliente NAMES LEGAL, fatturato direttamente da NAMES LEGAL. Lei non gestisce mai pagamenti, dati di carte o password.

1. Ottenere un canale di vendita#

Richieda al team NAMES LEGAL un canale di vendita. Esso contiene:

Impostazione	Scopo
Identificatore (`via`)	Il Suo nome tecnico, ad esempio `app-ecole`.
Siti autorizzati	Gli indirizzi della Sua applicazione autorizzati a mostrare il riquadro, uno per riga (`https://app.example.com`). Il riquadro rifiuta di apparire altrove.
Indirizzo di notifica	Facoltativo. L'endpoint del Suo server chiamato quando un sito acquistato tramite Lei è pronto.
Chiave di firma	Generata per Lei. Firma le notifiche.

2. Incollare il codice#

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

Lo script inserisce il riquadro nel punto in cui si trova e ne adatta automaticamente l'altezza.

Attributo	Obbligatorio	Effetto
`data-via`	sì	L'identificatore del Suo canale.
`data-lang`	no	Lingua del riquadro: `en`, `fr`, `de`, `it`, `es`, `pt`.
`data-email`, `data-first-name`, `data-last-name`	no	Precompilano l'account.
`data-name`	no	Nome dell'organizzazione; utilizzato anche per suggerire il nome del sito.
`data-site`	no	Nome del sito suggerito (`ecolehorizon` → `ecolehorizon.names.legal`).
`data-ref`	no	Identificatore Suo per questo utente. Le viene restituito quando il sito è pronto.
`data-plan`	no	Piano selezionato per impostazione predefinita.

Preferisce un semplice frame? Funziona anche così:

<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. Cosa vede il Suo utente#

Piano: mensile o annuale, add-on facoltativi.
Il proprio sito: nome (disponibilità verificata durante la digitazione) e lingue.
Il proprio account: nome utente e password per la propria console.
Pagamento: si apre una finestra di pagamento sicura sopra la Sua pagina. Il pagamento non è volutamente all'interno del riquadro: alcuni metodi di pagamento richiedono l'intera pagina, e il fornitore del servizio di pagamento sconsiglia di annidare il proprio checkout in riquadri.
Sito pronto: il riquadro lo comunica e propone di aprire la console.

Il riquadro non richiede cookie di terze parti, quindi funziona in Safari e nei browser che li bloccano.

4. Sapere quando il sito è pronto#

Nella pagina, senza server:

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

Sul Suo server, se ha dichiarato un indirizzo di notifica, riceve un evento site.ready firmato. Veda Webhook.

Sicurezza#

Il riquadro viene mostrato solo sugli indirizzi dichiarati per il Suo canale (Content-Security-Policy: frame-ancestors).
Lei non vede mai la password dell'utente né i dati di pagamento.
Il modulo di acquisto è protetto contro gli invii automatizzati e soggetto a limitazione di frequenza.