Elementen insluiten
Stel de ondertekenings-UI samen in uw React-product met getypte primitieven - Provider + status + ondertekenaar + componenten voor het vastleggen van handtekeningen die u in uw eigen paginashell weergeeft.
Integreer Elements in vier stappen
- 1
Installeer het pakket
Voeg @endorsed/elements toe aan uw React 18+ project. Peer-deps zijn alleen React en React DOM - geen SDK wildgroei van leveranciers.
- 2
Mint een ondertekensessietoken aan de serverzijde
POST vanuit uw backend /api/signing-sessions met de envelop-ID + e-mailadres van de ondertekenaar. Het antwoord bevat een token voor de ondertekeningssessie met een korte levensduur, gericht op die ondertekenaar.
- 3
Verpak uw ondertekenroute in <EndorsedProvider>
De provider draagt uw API-configuratie over naar de primitieven — geen prop-boren. Wissel het sessietoken in met useSigningSession() en render <EnvelopeStatus>, <SignerInfo> en <SignatureField> binnen uw eigen lay-out.
- 4
Handtekening indienen + status-callbacks afhandelen
useSignatureSubmit() post de vastgelegde handtekening naar /api/signing-sessions/:id/signature. Luister naar statusovergangen en leid de ondertekenaar naar uw eigen succes-/weigeringspagina''s wanneer SigningSessionStatus verandert.
Voorbeeld van minimale insluiting
Een configureerbaar signeeroppervlak met behulp van de meegeleverde primitieven. Vereisten: React 18+ en een token voor een ondertekeningssessie aan de serverzijde. Verwacht resultaat: een ondertekenaar ziet de envelopstatus, zijn identiteit en een handtekeningblok - allemaal in het chroom van uw product.
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 verzendt samenstelbare primitieven (Provider, weergave van status/ondertekenaar, vastleggen van handtekening). Stel de bovenstaande primitieven samen of sluit de gehoste ondertekenaar in via de ondertekeningssessie-URL.
Wat voor u het geval is bij het insluiten
Documentweergave
PDF rendering, zoom, scrollen en paginanavigatie — cross-browser, inclusief mobiele Safari.
Handtekening vastleggen
Handtekening tekenen, typen of uploaden. Consistente vastlegervaring op verschillende apparaten zonder browser-eigenaardigheden.
Identiteitsverificatie De
OTP-controle wordt binnen de insluiting afgehandeld. Er is geen aparte authenticatie-UI vereist in uw product.
Veldnavigatie
Begeleide veld-voor-veld navigatie met verplichte veldhandhaving voordat indiening is toegestaan.
Veelgestelde vragen
Elementen ingesloten — in uw product
Het ondertekenoppervlak wordt inline weergegeven op uw domein met uw merk. Uw productframe, uw koptekst, uw navigatie — EndorsedSign verzorgt de document- en veldinteractie.

Probeer Elements in uw eigen sandbox-tenant
Claim een sandbox via de quickstart, maak een ondertekensessietoken vanuit je backend en zet de bovenstaande primitieven neer in een React 18+ app.