Sviluppatori

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

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

Elenco dei documenti dei firmatari nel portale clienti con stati e azioni popolati
Elementi incorporati renderizzati all''interno di un prodotto SaaS immaginario. La superficie per la firma si trova all''interno della cromatura del prodotto: nessun reindirizzamento, nessun iframe, nessun marchio EndorsedSign visibile.

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