Desarrolladores

Elementos incrustados

Componga la interfaz de usuario de inicio de sesión en su producto React con primitivas escritas: proveedor + estado + firmante + componentes de captura de firma que representa dentro de su propio shell de página.

Integrar elementos en cuatro pasos

  1. 1

    Instalar el paquete

    Agrega @endorsed/elements a tu proyecto React 18+. Los departamentos de pares son React y React DOM únicamente, sin expansión de proveedores SDK.

  2. 2

    Crea un token de sesión de firma en el lado del servidor

    Desde su backend, PUBLICAR /api/signing-sessions con la identificación del sobre + correo electrónico del firmante. La respuesta contiene un token de sesión de firma de corta duración destinado a ese firmante.

  3. 3

    Envuelva su ruta de firma en <EndorsedProvider>

    El proveedor lleva su configuración API a las primitivas, sin necesidad de realizar perforaciones. Canjee el token de sesión con useSigningSession() y represente <EnvelopeStatus>, <SignerInfo> y <SignatureField> dentro de su propio diseño.

  4. 4

    Manejar envío de firma + devoluciones de llamada de estado

    useSignatureSubmit() publica la firma capturada en /api/signing-sessions/:id/signature. Escuche las transiciones de estado y dirija al firmante a sus propias páginas de éxito/rechazo cuando SigningSessionStatus cambie.

Ejemplo de inserción mínima

Una superficie de firma componible que utiliza las primitivas enviadas. Requisitos previos: React 18+ y un token de sesión de firma acuñado en el lado del servidor. Resultado esperado: un firmante ve el estado de su sobre, su identidad y un panel de firma, todo dentro del cromo de su producto.

tsx
import {
  EndorsedProvider,
  EnvelopeStatus,
  SignerInfo,
  SignatureField,
  useSigningSession,
} from '@endorsed/elements';

// 1. Wrap once at the app root (or per-signing-route).
export function App({ children }: { children: React.ReactNode }) {
  return (
    <EndorsedProvider
      baseUrl={process.env.NEXT_PUBLIC_ENDORSED_BASE_URL}
      // No API key in the browser. The provider only holds config.
    >
      {children}
    </EndorsedProvider>
  );
}

// 2. Render the signing surface. Compose these primitives into your
//    own page shell — headers, footers, and layout stay yours.
export function SigningPage({ sessionToken }: { sessionToken: string }) {
  const { status, envelope, signer } = useSigningSession(sessionToken);

  if (status === 'loading') return <p>Loading signing session…</p>;
  if (status === 'expired' || status === 'revoked') return <p>This link has expired.</p>;

  return (
    <section>
      <EnvelopeStatus value={envelope.status} />
      <SignerInfo values={{ name: signer.name, email: signer.email }} />
      <SignatureField
        onSubmitted={(result) => {
          // Advance your product state — redirect, mark task done, etc.
          console.log('Signature captured', result.signatureId);
        }}
      />
    </section>
  );
}

Elements incluye primitivas componibles (proveedor, visualización de estado/firmante, captura de firma). Redacte las primitivas anteriores o incruste el firmante alojado a través de la URL de la sesión de firma.

¿Qué maneja la inserción para usted?

📄

Representación de documentos

PDF renderizado, zoom, desplazamiento y navegación de páginas: en varios navegadores, incluido Safari móvil.

✍️

Captura de firma

Dibujar, escribir o cargar firma. Experiencia de captura consistente en todos los dispositivos sin peculiaridades del navegador.

🔐

Verificación de identidad

La verificación OTP se maneja dentro de la inserción. No se requiere una interfaz de usuario de autenticación separada en su producto.

📋

Navegación de campo

Navegación guiada campo por campo con aplicación de campos obligatorios antes de permitir el envío.

Preguntas comunes

Elementos incrustados: dentro de su producto

La superficie de firma se muestra en línea en su dominio con su marca. El marco de su producto, su encabezado, su navegación: EndorsedSign maneja el documento y la interacción del campo.

Lista de documentos del firmante en el portal del cliente con estados y acciones completos
Elementos incrustados renderizados dentro de un producto SaaS ficticio. La superficie de firma se encuentra dentro del cromo del producto: sin redirección, sin iframe, sin marca EndorsedSign visible.

Pruebe Elements en su propio inquilino sandbox

Reclame una zona de pruebas a través del inicio rápido, genere un token de sesión de firma desde su backend y coloque las primitivas anteriores en cualquier aplicación React 18+.