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

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