Documentation GigaSignature

Introduction

Bienvenue dans la documentation de GigaSignature, votre solution de signature électronique conforme au règlement eIDAS. Cette documentation vous guidera à travers toutes les fonctionnalités de notre plateforme, du démarrage rapide aux intégrations API avancées.

Démarrage rapide

GigaSignature simplifie le processus de signature électronique en 3 étapes simples :

1. Téléchargez votre document PDF
2. Configurez les zones de signature et invitez les signataires
3. Signez et recevez le document certifié

Créer un compte

Pour commencer à utiliser GigaSignature, vous devez créer un compte :

Étapes d'inscription

1. Accédez à la page d'inscription

   Cliquez sur "Créer un compte" depuis la page d'accueil

2. Remplissez le formulaire
   • Nom complet
   • Adresse email professionnelle
   • Mot de passe sécurisé (min. 8 caractères)
   • Nom de votre organisation
3. Validez votre email

   Un email de confirmation vous sera envoyé

4. Configurez votre profil

   Ajoutez vos informations de facturation si nécessaire

Télécharger un document

Formats acceptés

GigaSignature accepte uniquement les documents au format PDF pour garantir l'intégrité et la compatibilité.

Comment télécharger

1. Connectez-vous à votre tableau de bord
2. Cliquez sur "Nouveau processus de signature"
3. Glissez-déposez votre PDF ou cliquez pour parcourir
4. Attendez la fin du téléchargement

Processus multi-documents

Avantages des processus multi-documents

• Efficacité : Signez plusieurs documents en une seule session
• Cohérence : Assurez-vous que tous les documents sont signés ensemble
• Traçabilité : Un seul certificat pour l'ensemble du processus
• Simplicité : Une seule invitation pour tous les documents

Comment créer un processus multi-documents

1. Créez un nouveau processus

   Cliquez sur "Nouveau processus de signature"

2. Ajoutez plusieurs documents

   Téléchargez tous les PDF nécessaires (jusqu'à 10 documents)

3. Définissez l'ordre des documents

   Glissez-déposez pour réorganiser si nécessaire

4. Configurez les zones de signature

   Placez les champs sur chaque document

Configurer la signature

Types de champs disponibles

GigaSignature offre plusieurs types de champs pour répondre à tous vos besoins :

Placement des champs

Utilisez notre éditeur visuel intuitif :

• Glisser-déposer : Positionnez les champs où vous voulez
• Redimensionner : Ajustez la taille selon vos besoins
• Assigner : Attribuez chaque champ à un signataire
• Obligatoire/Optionnel : Définissez si le champ est requis

Options de signature

Paramètres de sécurité

• OTP obligatoire : Exiger une vérification par code
• Méthode OTP : Email, SMS ou choix du signataire
• Date d'expiration : Limite de temps pour signer

Inviter des signataires

Ajouter des signataires

Pour chaque signataire, vous devez fournir :

• Nom complet : Pour l'identification
• Email : Pour recevoir l'invitation
• Téléphone (optionnel) : Pour l'OTP SMS
• Message personnalisé : Instructions spécifiques

Types de signataires

Signer un document

Processus de signature

1. Recevoir l'invitation

   Le signataire reçoit un email avec un lien sécurisé

2. Vérifier son identité

   Entrer le code OTP reçu par email ou SMS

3. Consulter le document

   Lire toutes les pages du document

4. Apposer sa signature

   Cliquer sur "Signer" pour valider

5. Télécharger le certificat

   Recevoir le document signé et le certificat

Suivre le statut

États possibles

Notifications

Vous recevez des notifications pour :

• Chaque signature apposée
• Les refus de signature
• La complétion du processus
• Les rappels automatiques

Télécharger le certificat

Documents disponibles

Une fois le processus terminé, vous pouvez télécharger :

• Document signé : PDF avec toutes les signatures
• Certificat de signature : Preuve légale du processus
• Piste d'audit : Journal détaillé des actions

Contenu du certificat

Intégration API

Démarrage avec l'API

GigaSignature offre une API RESTful complète pour intégrer la signature électronique dans vos applications.

Authentification

Utilisez votre clé API dans l'en-tête Authorization :

Exemple complet : Créer un processus de signature

Voici un exemple complet pour créer et envoyer un processus de signature :

curl -X POST https://api.giga-signature.com/api/v1/documents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Accept: application/json" \
  -F "file=@contrat.pdf" \
  -F "name=Contrat de service 2025"

{
  "data": {
    "id": "doc_abc123",
    "name": "Contrat de service 2025",
    "pages": 5
  }
}

curl -X POST https://api.giga-signature.com/api/v1/signature-processes \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Contrat Client ABC",
    "description": "Contrat de service annuel",
    "sequential_signing": false,
    "require_otp": true,
    "otp_method": "choice",
    "documents": [
      {
        "document_id": "doc_abc123",
        "order": 1
      }
    ],
    "signers": [
      {
        "name": "Jean Dupont",
        "email": "jean.dupont@example.com",
        "phone": "+33612345678",
        "language": "fr"
      },
      {
        "name": "Marie Martin",
        "email": "marie.martin@example.com",
        "language": "fr"
      }
    ]
  }'

curl -X POST https://api.giga-signature.com/api/v1/signature-processes/proc_7h8i9j0k/fields \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": [
      {
        "document_id": "doc_abc123",
        "signature_id": "sig_1a2b3c4d",
        "type": "signature",
        "label": "Signature Client",
        "page": 5,
        "position_x": 15,
        "position_y": 70,
        "width": 25,
        "height": 10
      },
      {
        "document_id": "doc_abc123",
        "signature_id": "sig_2b3c4d5e",
        "type": "signature",
        "label": "Signature Partenaire",
        "page": 5,
        "position_x": 50,
        "position_y": 70,
        "width": 25,
        "height": 10
      }
    ]
  }'

curl -X POST https://api.giga-signature.com/api/v1/signature-processes/proc_7h8i9j0k/send \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Coffre-fort numérique (Vault)

Accédez aux documents signés stockés de manière sécurisée :

curl -X GET "https://api.giga-signature.com/api/v1/vault/documents?status=active&tags=contract,2025" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

curl -X GET "https://api.giga-signature.com/api/v1/vault/documents/123/package" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o "document-package.zip"

Webhooks

Configurez des webhooks pour recevoir des notifications en temps réel :

curl -X POST https://api.giga-signature.com/api/v1/webhooks \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/signature",
    "events": [
      "signature.completed",
      "signature.refused",
      "process.completed"
    ],
    "active": true
  }'

$payload = file_get_contents('php://input');
$signature = 'sha256=' . hash_hmac('sha256', $payload, $webhook_secret);
$is_valid = hash_equals($signature, $_SERVER['HTTP_X_SIGNATURE']);

const crypto = require('crypto');
const signature = 'sha256=' + crypto
  .createHmac('sha256', webhookSecret)
  .update(payload)
  .digest('hex');
const isValid = signature === req.headers['x-signature'];

Archives

Accédez aux processus archivés après 90 jours :

curl -X GET https://api.giga-signature.com/api/v1/archives/123/download \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o "archive-process-123.zip"

Gestion des erreurs

L'API retourne des messages d'erreur structurés :

{
  "error": {
    "code": "validation_error",
    "message": "Les données fournies sont invalides",
    "errors": {
      "signers.0.email": ["L'adresse email est invalide"],
      "file": ["Le fichier doit être un PDF"]
    }
  }
}

SDKs disponibles

Templates de documents

Qu'est-ce qu'un template ?

Un template est un modèle de document pré-configuré avec des zones de signature déjà définies. Idéal pour les documents récurrents comme les contrats types, les NDA, ou les formulaires standardisés.

Créer un template

1. Préparez votre document type

   Utilisez un PDF avec des espaces réservés pour les signatures

2. Créez un nouveau template

   Dans "Templates" > "Nouveau template"

3. Placez les zones de signature

   Définissez toutes les zones qui seront utilisées

4. Sauvegardez le template

   Donnez-lui un nom descriptif

Utiliser un template

Sécurité

Mesures de sécurité

GigaSignature met en œuvre les meilleures pratiques de sécurité :

Conformité

• eIDAS : Règlement européen sur l'identification électronique
• RGPD : Protection des données personnelles
• ISO 27001 : Management de la sécurité de l'information

Questions fréquentes

Support

Besoin d'aide ?

Notre équipe est là pour vous accompagner :