Aller au contenu

Signer dans votre page

La page de signature peut s’afficher dans votre page, sans fenêtre ni redirection : le signataire lit, reçoit son code et signe sans quitter votre site. Votre page apprend où il en est et comment il a répondu.

  1. Créez la demande sans envoi, pour que Tano n’écrive pas au signataire que vous allez recevoir chez vous : "delivery": "none" (voir le parcours).

  2. Obtenez son lien, côté serveur : POST /v1/signature-requests/{id}/signers/{signer_id}/link → {"url": "https://…/signer#tsig_…"}. Ne le stockez pas : redemandez-en un à chaque affichage.

  3. Affichez-le dans votre page.

    import { mountSigning } from "@tano-africa/web";
    const page = mountSigning("#signature", {
    url: lien, // reçu de votre serveur
    onStep: (step) => suivi(step), // "read", "code", "consent"
    onSigned: (requestStatus) => {
    // "completed" s'il était le dernier : votre serveur télécharge le document signé.
    },
    onDeclined: () => {},
    onEnded: (reason) => {}, // "closed" : expirée, annulée ou déjà close
    });
    // page.destroy() pour la retirer.

La page n’écrit qu’à l’origine qui a répondu à sa poignée de main. Aucun nom, aucun document, aucun jeton.

Événement Quand
tano:hello La page se déclare ; répondez tano:init. Rien ne s’affiche avant.
tano:ready La page est affichée, votre origine reconnue (kind: "signing").
tano:signing:step Le signataire passe à une étape : read (lire et remplir), code, consent.
tano:signing:signed Il a signé ; requestStatus vaut completed s’il était le dernier.
tano:signing:declined Il a refusé : la demande s’arrête.
tano:signing:ended La demande n’est plus signable (closed).

Donnez au cadre une hauteur fixe — min(720px, 85vh) convient à la plupart des pages, c’est celle du SDK (height). La page de signature est une application à la taille de son cadre : le document et le panneau de signature défilent à l’intérieur, comme sur un téléphone. Contrairement au parcours de vérification, elle n’annonce pas sa hauteur.

Un événement dit ce qui s’est passé dans la page ; il ne le prouve pas. Agissez sur l’état de la demande, lu côté serveur, ou sur les webhooks.

  • « Cette page ne peut pas s’afficher ici » : votre origine n’est pas parmi les domaines autorisés, ou votre page n’a pas répondu à tano:hello dans les cinq secondes.
  • Le cadre reste vide : vous encadrez /signer au lieu de /signer/embed. Seule cette adresse accepte d’être encadrée.

© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]