Ontwikkelaars

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

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

Ondertekenaarsdocumentenlijst in het klantportaal met ingevulde statussen en acties
Ingesloten elementen weergegeven in een fictief SaaS-product. Het ondertekeningsoppervlak bevindt zich in het chroom van het product - geen omleiding, geen iframe, geen EndorsedSign-branding zichtbaar.

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.