Elementi incorporati
Componi l''interfaccia utente di firma nel tuo prodotto React con primitive digitate: provider + stato + firmatario + componenti di acquisizione della firma renderizzati all''interno della tua shell di pagina.
Integra gli elementi in quattro passaggi
- 1
Installa il pacchetto
Aggiungi @endorsed/elements al tuo progetto React 18+. Le dipendenze peer sono solo React e React DOM: nessuna espansione dei fornitori SDK.
- 2
Conia un token per la sessione di firma lato server
Dal tuo backend, POST /api/signing-sessions con l''ID della busta + l''e-mail del firmatario. La risposta contiene un token della sessione di firma di breve durata con ambito limitato a quel firmatario.
- 3
Avvolgi il percorso della firma in <EndorsedProvider>
Il provider trasporta la tua configurazione API nelle primitive: nessuna perforazione dell''elica. Riscatta il token di sessione con useSigningSession() ed esegui il rendering di <EnvelopeStatus>, <SignerInfo> e <SignatureField> all''interno del tuo layout.
- 4
Gestisce l''invio della firma + le richiamate di stato
useSignatureSubmit() pubblica la firma acquisita in /api/signing-sessions/:id/signature. Ascolta le transizioni di stato e indirizza il firmatario alle tue pagine di successo/rifiuto quando SigningSessionStatus si inverte.
Esempio minimo di incorporamento
Una superficie di firma componibile utilizzando le primitive spedite. Prerequisiti: React 18+ e un token della sessione di firma coniato lato server. Output previsto: il firmatario vede lo stato della busta, la propria identità e un pad per la firma, il tutto all''interno del tuo prodotto Chrome.
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 fornisce primitive componibili (provider, visualizzazione stato/firmatario, acquisizione della firma). Componi le primitive sopra o incorpora il firmatario ospitato tramite l''URL della sessione di firma.
Che cosa gestisce l''incorporamento per te
Rendering del documento
PDF rendering, zoom, scorrimento e navigazione della pagina: multibrowser, incluso Safari mobile.
Acquisizione della firma
Disegna, digita o carica la firma. Esperienza di acquisizione coerente su tutti i dispositivi senza problemi del browser.
Verifica dell''identità Il controllo
OTP viene gestito all''interno dell''embed. Nel prodotto non è richiesta alcuna interfaccia utente di autenticazione separata.
Navigazione nel campo
Navigazione guidata campo per campo con applicazione dei campi obbligatori prima che sia consentito l''invio.
Domande comuni
Elementi incorporati: all''interno del tuo prodotto
La superficie di firma viene visualizzata in linea sul tuo dominio con il tuo marchio. La cornice del prodotto, l''intestazione, la navigazione: EndorsedSign gestisce l''interazione tra documenti e campi.

Prova Elements nel tuo tenant sandbox
Richiedi un sandbox tramite l''avvio rapido, conia un token per la sessione di firma dal tuo backend e rilascia le primitive sopra in qualsiasi app React 18+.