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.
-
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). -
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. -
Affichez-le dans votre page.
import { mountSigning } from "@tano-africa/web";const page = mountSigning("#signature", {url: lien, // reçu de votre serveuronStep: (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.<iframe id="signature" title="Signature" style="width:100%;height:min(720px,85vh);border:0"></iframe><script>const lien = new URL(lienRecuDuServeur);lien.pathname = "/signer/embed"; // la seule adresse de signature encadrableconst cadre = document.getElementById("signature");cadre.src = lien.toString();window.addEventListener("message", (event) => {if (event.source !== cadre.contentWindow || event.origin !== lien.origin) return;const message = event.data;if (message.type === "tano:hello") {cadre.contentWindow.postMessage({ type: "tano:init", version: 1 }, lien.origin);} else if (message.type === "tano:signing:signed") {// message.requestStatus : "completed" s'il était le dernier}});</script>
Les événements
Section intitulée « Les événements »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). |
La hauteur du cadre
Section intitulée « La hauteur du cadre »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.
Si la page ne s’affiche pas
Section intitulée « Si la page ne s’affiche pas »- « 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:hellodans les cinq secondes. - Le cadre reste vide : vous encadrez
/signerau lieu de/signer/embed. Seule cette adresse accepte d’être encadrée.
Étapes suivantes
Section intitulée « Étapes suivantes »- Le parcours du signataire : envoi, textes, retours, relances.
- Le SDK web.
© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]