Developers

Compra integrada#

Permita que sus usuarios creen y paguen un sitio NAMES LEGAL sin salir de su aplicación. Usted pega una línea de código; aparece un marco en su página y toda la compra sucede dentro de él.

Su usuario se convierte en cliente de NAMES LEGAL, facturado directamente por NAMES LEGAL. Usted nunca gestiona pagos, datos de tarjetas ni contraseñas.

1. Obtenga un canal de venta#

Solicite al equipo de NAMES LEGAL un canal de venta. Este contiene:

Ajuste Propósito
Identificador (via) Su nombre técnico, por ejemplo app-ecole.
Sitios permitidos Las direcciones de su aplicación autorizadas a mostrar el marco, una por línea (https://app.example.com). El marco se niega a aparecer en cualquier otro sitio.
Dirección de notificación Opcional. El endpoint de su servidor al que se llama cuando un sitio comprado a través de usted está listo.
Secreto de firma Generado para usted. Firma las notificaciones.

2. Pegue el 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>

El script inserta el marco donde se encuentra y ajusta su altura automáticamente.

Atributo Obligatorio Efecto
data-via sí Su identificador de canal.
data-lang no Idioma del marco: en, fr, de, it, es, pt.
data-email, data-first-name, data-last-name no Rellenan de antemano la cuenta.
data-name no Nombre de la organización; también se usa para sugerir el nombre del sitio.
data-site no Nombre de sitio sugerido (ecolehorizon → ecolehorizon.names.legal).
data-ref no Su identificador para este usuario. Se le devuelve cuando el sitio está listo.
data-plan no Plan seleccionado por defecto.

¿Prefiere un marco sencillo? También 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. Lo que ve su usuario#

  1. Plan: mensual o anual, add-ons opcionales.
  2. Su sitio: nombre (disponibilidad verificada mientras escribe) e idiomas.
  3. Su cuenta: usuario y contraseña para su consola.
  4. Pago: se abre una ventana de pago segura encima de su página. El pago no está dentro del marco a propósito: algunos métodos de pago necesitan la página completa, y el proveedor de pagos desaconseja anidar su pasarela de pago en marcos.
  5. Sitio listo: el marco lo indica y ofrece abrir la consola.

El marco no necesita ninguna cookie de terceros, por lo que funciona en Safari y en navegadores que las bloquean.

4. Sepa cuándo el sitio está listo#

En la página, sin servidor:

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

En su servidor, si declaró una dirección de notificación, recibe un evento site.ready firmado. Vea Webhooks.

Seguridad#

  • El marco solo se muestra en las direcciones declaradas para su canal (Content-Security-Policy: frame-ancestors).
  • Usted nunca ve la contraseña ni los datos de pago del usuario.
  • El formulario de compra está protegido contra envíos automatizados y tiene un límite de frecuencia.