Comment localiser vos flux de signature électronique pour les utilisateurs internationaux

Si vous intégrez l'expérience de signature de Firma.dev dans votre application, vous voulez probablement qu'elle corresponde à la langue de votre utilisateur. Ce guide explique comment Firma.dev gère la localisation et comment la contrôler dans votre intégration.

Comment Firma.dev détecte la langue

Firma.dev utilise un système de détection à trois niveaux, vérifié dans cet ordre :

1. Paramètre URL (?lang=xx) — Priorité la plus élevée. Si vous passez un code de langue dans l'URL, c'est ce que l'utilisateur voit.

2. Stockage local — Lors des visites de retour, Firma.dev vérifie une préférence de langue mise en cache. Cela permet une sélection de langue instantanée sans requête réseau.

3. Détection du navigateur — Reprend les réglages de langue du navigateur ou du système de l'utilisateur.

Si la langue détectée n'est pas l'une des 7 langues prises en charge, Firma.dev revient par défaut à l'anglais.

Langues prises en charge

Firma.dev prend en charge ces langues prêtes à l'emploi :

Tous les éléments d'interface utilisateur, boutons, étiquettes, notifications, emails et messages d'erreur sont entièrement traduits dans chaque langue.

Contrôler la langue dans les signatures intégrées

Lorsque vous intégrez le flux de signature dans une iframe, la détection du navigateur ne fonctionne pas de manière fiable. L'iframe hérite du contexte de la page parente, et non des paramètres du navigateur de l'utilisateur. Vous devez passer la langue explicitement.

Ajoutez le paramètre ?lang= à l'URL de signature :

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}?lang=es"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Firmar Documento"
></iframe>

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}?lang=es"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Firmar Documento"
></iframe>

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}?lang=es"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Firmar Documento"
></iframe>

Source: Guide de Localisation

Cela oblige l'interface de signature à s'afficher en espagnol, quel que soit le réglage du navigateur de l'utilisateur.

Récupérer les URL de signature et afficher l'iframe

Voici comment obtenir l'URL de signature depuis l'API et l'afficher dynamiquement :

// fetch signing request
const r = await fetch('/internal/signing-request/' + signingRequestId)
const json = await r.json()

// get recipient signing URL
const recipient = json.recipients[0]
const signingUrl = recipient.signing_url || `https://app.firma.dev/signing/${recipient.id}`

// render iframe
const iframe = document.createElement('iframe')
iframe.src = signingUrl
iframe.style.width = '100%'
iframe.style.height = '900px'
iframe.frameBorder = '0'
iframe.allow = 'camera;microphone;clipboard-write'
document.getElementById('signing-root').appendChild(iframe)

// fetch signing request
const r = await fetch('/internal/signing-request/' + signingRequestId)
const json = await r.json()

// get recipient signing URL
const recipient = json.recipients[0]
const signingUrl = recipient.signing_url || `https://app.firma.dev/signing/${recipient.id}`

// render iframe
const iframe = document.createElement('iframe')
iframe.src = signingUrl
iframe.style.width = '100%'
iframe.style.height = '900px'
iframe.frameBorder = '0'
iframe.allow = 'camera;microphone;clipboard-write'
document.getElementById('signing-root').appendChild(iframe)

// fetch signing request
const r = await fetch('/internal/signing-request/' + signingRequestId)
const json = await r.json()

// get recipient signing URL
const recipient = json.recipients[0]
const signingUrl = recipient.signing_url || `https://app.firma.dev/signing/${recipient.id}`

// render iframe
const iframe = document.createElement('iframe')
iframe.src = signingUrl
iframe.style.width = '100%'
iframe.style.height = '900px'
iframe.frameBorder = '0'
iframe.allow = 'camera;microphone;clipboard-write'
document.getElementById('signing-root').appendChild(iframe)

Source: Guide d'envoi d'une demande de signature

Pour correspondre à la locale de votre application, ajoutez le paramètre langue lors de la définition de la source de l'iframe :

const userLocale = getCurrentUserLocale() // returns 'es', 'de', 'fr', etc.
iframe.src = `${signingUrl}?lang=${userLocale}`

const userLocale = getCurrentUserLocale() // returns 'es', 'de', 'fr', etc.
iframe.src = `${signingUrl}?lang=${userLocale}`

const userLocale = getCurrentUserLocale() // returns 'es', 'de', 'fr', etc.
iframe.src = `${signingUrl}?lang=${userLocale}`

Cela garantit que l'expérience de signature est cohérente avec le reste de votre application.

Meilleures pratiques

Ces directives proviennent directement de la documentation de Firma.dev :

• Utilisez le paramètre lang dans la signature intégrée — Ne vous fiez pas à la détection du navigateur dans les contextes iframe. Passez la langue explicitement pour garantir une expérience cohérente.

• Adaptez-vous au locale de votre application — Lors de l'intégration de Firma.dev, passez le même locale que votre application utilise pour que l'expérience de signature soit transparente.

• Laissez les utilisateurs choisir — Pour les liens directs de Firma.dev (par exemple, dans les emails), omettez le paramètre lang et laissez la détection automatique de Firma.dev s'en occuper. Les utilisateurs qui ont défini une préférence verront leur langue choisie.

Source: Guide de Localisation

Localisation dans d'autres composants intégrables

Le paramètre ?lang= fonctionne de la même manière pour les autres composants intégrables de Firma.dev :

• Éditeur de modèles intégrable — Pour créer et éditer des modèles de documents

• Éditeur de demande de signature intégrable — Pour configurer les destinataires et les options d'envoi

Les deux utilisent l'authentification JWT et prennent en charge les 7 langues. Voir le Guide de l'éditeur de demandes de signature intégrable pour les détails de l'implémentation.

Une note sur l'infrastructure

Firma.dev est hébergé dans l'UE (région AWS de Paris), ce qui se marie bien avec le support multilingual si vous desservez les marchés européens. La plateforme prend en charge le RGPD et eIDAS (niveaux SES et AdES) pour les besoins de conformité régionale.

Prochaines étapes

Pour la référence technique complète, consultez le Guide de Localisation dans les documents. Il couvre des cas particuliers comme les équipes multilingues et le comportement de persistance de la langue.

Prêt à construire ? Obtenez votre clé API maintenant et commencez à intégrer des signatures électroniques localisées. Aucune carte bancaire requise.