Compra integrada#

Permita que os seus utilizadores criem e paguem um site NAMES LEGAL sem sair da sua aplicação. Basta colar uma linha de código; uma moldura aparece na sua página e toda a compra decorre dentro dela.

O seu utilizador torna-se cliente do NAMES LEGAL, faturado diretamente pelo NAMES LEGAL. Os pagamentos, dados de cartão ou palavras-passe nunca são tratados pela sua aplicação.

1. Obtenha um canal de venda#

Peça à equipa NAMES LEGAL um canal de venda. Este contém:

Definição	Finalidade
Identificador (`via`)	O seu nome técnico, por exemplo `app-ecole`.
Sites permitidos	Os endereços da sua aplicação autorizados a mostrar a moldura, um por linha (`https://app.example.com`). A moldura recusa-se a aparecer em qualquer outro local.
Endereço de notificação	Opcional. O endpoint do seu servidor chamado quando um site comprado através de si fica pronto.
Segredo de assinatura	Gerado automaticamente. Assina as notificações.

2. Cole o código#

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

O script insere a moldura no local onde se encontra e ajusta automaticamente a sua altura.

Atributo	Obrigatório	Efeito
`data-via`	sim	O identificador do canal.
`data-lang`	não	Idioma da moldura: `en`, `fr`, `de`, `it`, `es`, `pt`.
`data-email`, `data-first-name`, `data-last-name`	não	Preenchem previamente a conta.
`data-name`	não	Nome da organização; também utilizado para sugerir o nome do site.
`data-site`	não	Nome de site sugerido (`ecolehorizon` → `ecolehorizon.names.legal`).
`data-ref`	não	Identificador próprio para este utilizador. É devolvido quando o site fica pronto.
`data-plan`	não	Plano selecionado por predefinição.

Prefere uma simples moldura (iframe)? Também funciona:

<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. O que o utilizador vê#

Plano: mensal ou anual, add-ons opcionais.
O seu site: nome (disponibilidade verificada durante a digitação) e idiomas.
A sua conta: nome de utilizador e palavra-passe para a consola.
Pagamento: abre-se uma janela de pagamento segura sobre a página. O pagamento não está dentro da moldura de propósito: alguns métodos de pagamento precisam da página inteira, e o fornecedor de pagamentos desaconselha incluir o seu checkout dentro de molduras.
Site pronto: a moldura informa e propõe abrir a consola.

A moldura não precisa de nenhum cookie de terceiros, pelo que funciona no Safari e em browsers que os bloqueiam.

4. Saber quando o site está pronto#

Na página, sem servidor:

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

No servidor, caso tenha sido declarado um endereço de notificação, é recebido um evento site.ready assinado. Consulte Webhooks.

Segurança#

A moldura só é apresentada nos endereços declarados para o canal (Content-Security-Policy: frame-ancestors).
A palavra-passe do utilizador e os dados de pagamento nunca ficam visíveis.
O formulário de compra está protegido contra submissões automatizadas e sujeito a limite de pedidos.