Oui, vous pouvez générer les certificats d'une formation en ligne sans les copier-coller un par un. Le montage le plus direct tient en quatre fichiers : un CSV de participants, un template HTML, un script Python et une base SQLite. WeasyPrint transforme le HTML en PDF, qrcode ajoute un QR de vérification, et chaque fichier reçoit un identifiant unique.

Pour 500 apprenants, comptez une soirée pour écrire et tester le pipeline, puis quelques minutes par promotion. Le stockage de 500 PDF de 250 Ko représente 125 Mo, sous les 10 Go inclus chaque mois chez Cloudflare R2. L'envoi tient dans l'offre gratuite de Resend si vous étalez les messages sur cinq jours, ou dans le forfait Pro à 20 $ par mois pour 50 000 e-mails.

Les versions et les prix cités ont été relevés en novembre 2026 : WeasyPrint 70.0, Jinja 3.1.6, Typst 0.15, Resend et Cloudflare R2. Le tutoriel produit un certificat de formation, pas un titre professionnel reconnu par l'État : les mentions et la valeur juridique dépendent de votre cadre, notamment si la formation est financée.

Un certificat crédible tient à quatre preuves#

Un certificat de formation doit répondre à quatre questions sans que le lecteur ait à vous appeler. Qui l'a émis ? Qui l'a reçu ? Pour quelle formation, quelle durée et quelle date ? Et comment vérifier que le document n'a pas été fabriqué après coup ?

La première preuve est l'identité de l'émetteur : votre organisme, votre école ou votre nom d'activité, avec un logo et une adresse de contact. La deuxième est l'accomplissement : l'intitulé exact de la formation, le nombre d'heures, la date de fin et, si vous en avez une, la mention du niveau ou des compétences validées. La troisième est un identifiant unique, lisible et non devinable : WEB-2026-7F3A9C21B4E6D8 vaut mieux qu'un numéro séquentiel. La quatrième est un chemin de vérification : une URL publique qui affiche le statut du certificat à partir de cet identifiant.

Un PDF seul ne prouve rien. N'importe quel éditeur graphique ou outil en ligne peut modifier un nom et réexporter le fichier. Ce qui rend le certificat vérifiable, c'est la combinaison d'un identifiant, d'un registre que vous contrôlez et d'une page publique qui répond à une question simple : cet identifiant existe-t-il, et à quel nom est-il associé ? Le QR code ne fait que raccourcir le chemin vers cette page ; il n'apporte pas la preuve à lui seul.

Pour une preuve portable, regardez du côté d'Open Badges 3.0. Le standard décrit un fichier JSON-LD signé, compatible avec le modèle de Verifiable Credentials 2.0 du W3C, que l'apprenant peut importer dans un portefeuille numérique. C'est plus de travail que notre pipeline, mais c'est le bon format si vos certificats doivent circuler hors de votre site.

L'architecture : quatre fichiers, deux services#

Le pipeline sépare ce qui change souvent de ce qui change rarement. La liste des participants change à chaque promotion ; le template change quand vous refaites votre charte ; le script et le registre restent stables.

Fichier ou serviceRôle
participants.csvUne ligne par apprenant : nom, e-mail, formation, heures
certificat.htmlLe template Jinja avec la mise en page A4 paysage
generate.pyLit le CSV, rend le HTML, produit le PDF et remplit le registre
registre.sqlite3Identifiants, empreintes SHA-256 et statut des certificats
Cloudflare R2Stockage des PDF, sans frais de sortie réseau
ResendEnvoi des e-mails avec le lien de téléchargement

SQLite suffit pour ce volume : la bibliothèque est incluse dans Python, le fichier tient sur un disque et une requête par identifiant reste instantanée. Si votre plateforme de formation a déjà une base de données, utilisez-la plutôt que de créer un second registre. L'important est qu'une seule source fasse autorité.

Le registre ne stocke pas les PDF. Il garde l'identifiant, le nom, l'e-mail, la formation, la date, l'empreinte SHA-256 du fichier et un statut (valide, révoqué). Cette séparation évite de dupliquer des documents et permet de révoquer un certificat sans supprimer le PDF déjà téléchargé : la page de vérification répondra « révoqué » même si le fichier circule encore.

Étape 1 — installer l'outil et préparer la liste#

WeasyPrint 70.0 demande Python 3.10 ou plus récent et Pango 1.44 ou plus récent. Sous Debian ou Ubuntu, installez les bibliothèques système avant le paquet Python. poppler-utils servira ensuite à vérifier que le texte du PDF est extractible.

bash
mkdir certificats && cd certificats
python3 --version
python3 -m venv .venv
source .venv/bin/activate
sudo apt install libpango-1.0-0 libharfbuzz0b libpangoft2-1.0-0 libharfbuzz-subset0 poppler-utils
pip install "weasyprint==70.0" "jinja2==3.1.6" "qrcode[pil]" boto3
weasyprint --version

Sous macOS, remplacez la ligne apt par brew install pango poppler. Sous Windows, le plus simple est d'utiliser l'exécutable de WeasyPrint pour la ligne de commande, ou WSL pour retrouver l'environnement Linux. La bibliothèque qrcode[pil] installe Pillow, nécessaire pour écrire le QR en PNG.

Le fichier participants.csv doit être en UTF-8 et contenir un en-tête. Exportez-le depuis votre LMS, Google Sheets ou Excel en choisissant « CSV UTF-8 », pas « CSV (séparé par des virgules) » sur les versions anciennes d'Excel qui utilisent un autre encodage. Le script ouvre le fichier en utf-8-sig, ce qui accepte le BOM ajouté par Excel.

csv
nom,email,formation,heures
Amina Diallo,[email protected],Développement web full-stack,60
Lucas Martin,[email protected],Développement web full-stack,60

Ne stockez que ce dont vous avez besoin. Pour un certificat, le nom, l'e-mail, l'intitulé de la formation et la durée suffisent. Une date de naissance, une adresse postale ou un numéro de téléphone ajoutent une donnée personnelle à protéger sans améliorer le document.

Étape 2 — écrire le template HTML#

Le template utilise une page A4 paysage, une seule colonne et une police installée sur la machine. Aucune ressource distante n'est chargée : le QR est intégré en data URI, donc le rendu ne dépend pas du réseau.

html
<!doctype html>
<html lang="fr">
<head>
  <meta charset="utf-8">
  <title>Certificat — {{ learner_name }}</title>
  <style>
    @page { size: A4 landscape; margin: 0; }
    * { box-sizing: border-box; }
    body { margin: 0; font-family: "DejaVu Sans", sans-serif; color: #17211b; }
    .page { width: 297mm; height: 210mm; padding: 18mm; background: #f7f4ec; }
    .frame {
      height: 100%; border: 1.2mm solid #1f5c45; padding: 14mm;
      display: flex; flex-direction: column; justify-content: space-between;
    }
    .eyebrow { font-size: 11pt; letter-spacing: .18em; text-transform: uppercase; color: #1f5c45; }
    h1 { font-size: 34pt; margin: 4mm 0 2mm; }
    .name { font-size: 30pt; font-weight: 700; margin: 6mm 0; }
    h2 { font-size: 18pt; margin: 2mm 0; }
    .meta { font-size: 12pt; color: #4b5a51; }
    .bottom { display: flex; align-items: flex-end; justify-content: space-between; gap: 10mm; }
    .qr { width: 30mm; height: 30mm; }
    .id { font-family: monospace; font-size: 9pt; color: #4b5a51; }
  </style>
</head>
<body>
  <div class="page">
    <div class="frame">
      <p class="eyebrow">{{ issuer }}</p>
      <div>
        <h1>Certificat de réussite</h1>
        <p>décerné à</p>
        <p class="name">{{ learner_name }}</p>
        <p>pour avoir terminé la formation</p>
        <h2>{{ course }}</h2>
        <p class="meta">{{ hours }} heures · {{ issued_on }}</p>
      </div>
      <div class="bottom">
        <div>
          <p class="id">N° {{ certificate_id }}</p>
          <p class="id">{{ verify_url }}</p>
        </div>
        <img class="qr" src="{{ qr_data_uri }}" alt="QR code de vérification">
      </div>
    </div>
  </div>
</body>
</html>

Trois choix de mise en page comptent. La page est paysage parce qu'un certificat se lit comme une affiche, pas comme une lettre. Le cadre intérieur garde une marge de sécurité à l'impression. Et le nom occupe la plus grande taille : c'est ce que l'apprenant photographiera pour son profil professionnel.

Vérifiez la police avec fc-match "DejaVu Sans". Si vous utilisez une police de marque, copiez le fichier dans ~/.local/share/fonts, puis déclarez-la avec @font-face et un chemin local. Une police absente ne casse pas le rendu : Pango prend une police de substitution, ce qui peut décaler les lignes et changer l'apparence du certificat.

Étape 3 — générer les PDF et le registre#

Le script suivant lit le CSV, crée un identifiant aléatoire, fabrique le QR, rend le HTML, calcule l'empreinte du PDF et écrit le tout. Il utilise write_pdf() sans argument, qui renvoie les octets du PDF en mémoire, comme le documente l'API WeasyPrint.

python
import base64
import csv
import hashlib
import io
import sqlite3
import uuid
from datetime import date
from pathlib import Path

import qrcode
from jinja2 import Environment, FileSystemLoader, select_autoescape
from weasyprint import HTML

ROOT = Path(__file__).parent
OUT = ROOT / "out"
OUT.mkdir(exist_ok=True)
VERIFY_BASE = "https://votre-domaine.tld/verifier/"
ISSUER = "Acme Academy"
COURSE = "Développement web full-stack"
HOURS = 60

env = Environment(
    loader=FileSystemLoader(ROOT),
    autoescape=select_autoescape(["html"]),
)
template = env.get_template("certificat.html")

db = sqlite3.connect(ROOT / "registre.sqlite3")
db.execute("""
    CREATE TABLE IF NOT EXISTS certificats (
        id TEXT PRIMARY KEY,
        nom TEXT NOT NULL,
        email TEXT NOT NULL,
        formation TEXT NOT NULL,
        heures INTEGER NOT NULL,
        date TEXT NOT NULL,
        sha256 TEXT NOT NULL,
        statut TEXT NOT NULL DEFAULT 'valide'
    )
""")

with (ROOT / "participants.csv").open(newline="", encoding="utf-8-sig") as f:
    rows = list(csv.DictReader(f))

for row in rows:
    nom = row["nom"].strip()
    email = row["email"].strip()
    if not nom or "@" not in email:
        raise ValueError(f"Ligne invalide : {row}")

    cert_id = f"WEB-2026-{uuid.uuid4().hex[:16].upper()}"
    verify_url = VERIFY_BASE + cert_id
    issued_on = date.today().strftime("%d/%m/%Y")

    qr = qrcode.make(verify_url)
    buffer = io.BytesIO()
    qr.save(buffer, format="PNG")
    qr_uri = "data:image/png;base64," + base64.b64encode(buffer.getvalue()).decode()

    formation = (row.get("formation") or COURSE).strip()
    heures = int(row.get("heures") or HOURS)

    html = template.render(
        issuer=ISSUER,
        learner_name=nom,
        course=formation,
        hours=heures,
        issued_on=issued_on,
        certificate_id=cert_id,
        verify_url=verify_url,
        qr_data_uri=qr_uri,
    )

    pdf = HTML(string=html, base_url=str(ROOT)).write_pdf()
    digest = hashlib.sha256(pdf).hexdigest()
    (OUT / f"{cert_id}.pdf").write_bytes(pdf)

    db.execute(
        """INSERT INTO certificats
           (id, nom, email, formation, heures, date, sha256)
           VALUES (?, ?, ?, ?, ?, ?, ?)""",
        (cert_id, nom, email, formation, heures, issued_on, digest),
    )
    print(f"{cert_id} {digest[:12]}")

db.commit()
db.close()

La ligne HTML(string=html, base_url=str(ROOT)) donne un point d'ancrage aux chemins relatifs, même si le template n'en utilise pas ici. L'empreinte est calculée sur les octets exacts du PDF, avant l'écriture du fichier : c'est cette valeur que le registre conservera. Si vous régénérez le même certificat, le PDF change (date de création, identifiant interne) et l'empreinte change aussi ; c'est normal, un certificat émis ne doit pas être réécrit à l'identique.

Lancez la génération, puis inspectez un fichier. pdfinfo affiche le nombre de pages et la taille de page ; pdftotext montre le texte que lira un moteur de recherche ou un parseur.

bash
python generate.py
ls -lh out | head
first=$(ls out/*.pdf | head -1)
pdfinfo "$first" | grep -E "Pages|Page size"
pdftotext "$first" - | head -30

Le PDF doit tenir sur une page, afficher le nom, la formation, la date, l'identifiant et l'URL de vérification. Si le texte contient des carrés à la place des accents, la police n'a pas les glyphes ; si pdftotext ne renvoie rien, le document a été rendu comme une image, ce qui n'est pas le cas ici.

Étape 4 — vérifier un certificat#

Le registre sert à deux choses : répondre à la page publique et contrôler qu'un fichier reçu correspond bien à ce que vous avez émis. Le script ci-dessous fait le second contrôle en ligne de commande.

python
import hashlib
import sqlite3
import sys
from pathlib import Path

cert_id = sys.argv[1]
pdf_path = Path(sys.argv[2])

with sqlite3.connect("registre.sqlite3") as db:
    row = db.execute(
        """SELECT nom, formation, heures, date, sha256, statut
           FROM certificats WHERE id = ?""",
        (cert_id,),
    ).fetchone()

if row is None:
    raise SystemExit("Certificat inconnu")

nom, formation, heures, date_emission, digest, statut = row
if statut != "valide":
    raise SystemExit(f"Certificat {statut}")

if hashlib.sha256(pdf_path.read_bytes()).hexdigest() != digest:
    raise SystemExit("Le PDF ne correspond pas au registre")

print(f"Valide : {nom} — {formation} — {heures} h — {date_emission}")
bash
python verifier.py WEB-2026-7F3A9C21B4E6D8 out/WEB-2026-7F3A9C21B4E6D8.pdf

Cette vérification a une limite précise : elle compare un fichier à votre registre, elle ne prouve pas au monde entier que l'émetteur est bien vous. La page publique, elle, doit être servie par votre domaine et interroger la même base. Une page de vérification correcte affiche le statut, la formation, la date et un nom masqué (Amina D.), jamais l'adresse e-mail. L'identifiant étant aléatoire, le QR ne révèle aucune donnée personnelle.

Si vous voulez une preuve qui voyage sans votre serveur, signez une assertion Open Badges 3.0 et publiez le fichier JSON-LD à côté du PDF. La signature cryptographique permet à un tiers de vérifier l'émetteur sans appeler votre base. Pour la plupart des formations indépendantes, le registre et la page publique suffisent ; pour un programme financé ou un partenariat, le standard devient utile.

Pour héberger la page de vérification et le site de la formation, notre guide de déploiement Next.js avec Coolify couvre le domaine et HTTPS. Si vous stockez les PDF chez vous plutôt que dans R2, notre tutoriel de sauvegarde PostgreSQL vers un stockage objet S3 détaille les buckets et les clés d'accès.

Étape 5 — stocker et envoyer#

Cloudflare R2 expose une API compatible S3, avec la région auto. Créez un bucket certificats, un jeton d'API limité à ce bucket, puis exportez les trois valeurs dans votre terminal. Ne mettez jamais ces clés dans le dépôt Git.

bash
export R2_ACCOUNT_ID="votre_compte"
export R2_ACCESS_KEY_ID="votre_cle"
export R2_SECRET_ACCESS_KEY="votre_secret"
python
import os
from pathlib import Path

import boto3

s3 = boto3.client(
    "s3",
    endpoint_url=f"https://{os.environ['R2_ACCOUNT_ID']}.r2.cloudflarestorage.com",
    aws_access_key_id=os.environ["R2_ACCESS_KEY_ID"],
    aws_secret_access_key=os.environ["R2_SECRET_ACCESS_KEY"],
    region_name="auto",
)

for pdf in Path("out").glob("*.pdf"):
    s3.upload_file(
        str(pdf),
        "certificats",
        f"2026/{pdf.name}",
        ExtraArgs={"ContentType": "application/pdf"},
    )

L'envoi par e-mail peut se faire avec l'API Resend. Le point d'entrée accepte un expéditeur avec un nom lisible, un destinataire, un sujet et un corps HTML. Le lien pointe vers votre page de vérification, pas directement vers un fichier public non contrôlé : vous pouvez ainsi révoquer un certificat sans courir après les PDF déjà téléchargés.

bash
curl -X POST https://api.resend.com/emails \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme Academy <[email protected]>",
    "to": ["[email protected]"],
    "subject": "Votre certificat de réussite",
    "html": "<p>Bonjour Amina,</p><p>Votre certificat est disponible : <a href=\"https://votre-domaine.tld/verifier/WEB-2026-7F3A9C21B4E6D8\">vérifier et télécharger</a>.</p>"
  }'

Pour une promotion, l'API Batch accepte jusqu'à 100 e-mails par requête, ce qui évite 500 appels HTTP individuels. La limite quotidienne de l'offre gratuite reste de 100 messages : 500 certificats partent donc sur cinq jours, ou avec le forfait Pro à 20 $ par mois. Si vous comparez les fournisseurs, notre comparatif Resend, Brevo et Postmark détaille les quotas et la délivrabilité.

Trois chemins selon qui maintient la page de vérification#

Le pipeline maison donne le contrôle total, mais il faut maintenir le script, le domaine et la page de vérification. Les deux autres options réduisent ce travail, avec des compromis différents.

ApprocheCoûtMise en placeVérificationPour qui
Pipeline WeasyPrint0 € + votre tempsUne soiréeVotre page + registreDéveloppeur qui veut tout contrôler
Certifstudio20 certificats/mois gratuits ; Solo 7 €/mois en annuel ; Pro 23 €/mois en annuel4 minutesQR et page de vérification fournisFormateur ou école sans équipe technique
Typst0 €, open sourceQuelques heuresÀ construireDocuments très typés ou gros volumes

Certifstudio, édité par le même éditeur que ce blog, annonce 2 051 modèles et un import Excel ou CSV. L'offre gratuite couvre 20 certificats par mois avec la mention du service ; Solo passe à 200 certificats par mois et retire la mention pour 7 € par mois facturés à l'année, ou 9 € au mois ; Pro monte à 2 000 certificats par mois et ajoute l'envoi par e-mail et une page de vérification à votre nom pour 23 € par mois en annuel, ou 29 € au mois. C'est une option pertinente quand la remise doit partir le jour même et que personne ne veut maintenir un script Python.

Typst 0.15, publié le 15 juin 2026, est un compilateur open source qui produit des PDF à partir d'un balisage proche de Markdown. Il gère très bien la typographie et la mise en page, mais il faut réécrire le template et construire la vérification. WeasyPrint 70.0 reste le choix le plus direct si vous partez d'un template HTML existant.

Les détails qui font gagner une heure#

Testez les noms longs et les accents. Un nom de 45 caractères peut sortir de la page ou chevaucher le QR. Ajoutez une ligne de test avec un prénom composé, un nom à particule et des caractères comme É, ç ou ñ. Si le nom dépasse, réduisez la taille de police ou autorisez un retour à la ligne dans .name ; ne rognez jamais le texte.

Authentifiez votre domaine avant le premier envoi. Resend, comme les autres fournisseurs, demande des enregistrements DNS SPF, DKIM et DMARC. Sans eux, les messages partent en spam ou sont rejetés. Faites le test sur une adresse que vous contrôlez avant d'écrire à 500 apprenants.

Ne versionnez pas le registre. Le fichier SQLite contient des noms et des adresses e-mail. Mettez-le dans .gitignore et sauvegardez-le séparément, avec un chiffrement au repos. Le CSV de travail et les PDF produits doivent suivre la même règle.

Prévoyez la suppression. Une personne peut demander la suppression de ses données. Votre registre doit permettre de supprimer la ligne ou de l'anonymiser, et la page de vérification doit alors répondre « certificat révoqué » plutôt que de garder le nom indéfiniment.

Testez l'accessibilité. WeasyPrint peut produire un PDF balisé avec pdf_tags=True ou un profil PDF/UA avec pdf_variant="pdf/ua-1", mais sa documentation précise que la validité n'est pas garantie. Passez le fichier dans un vérificateur PDF/UA et gardez un texte de remplacement sur le QR. Un lecteur d'écran doit pouvoir annoncer le nom et la formation.

Gardez une trace des envois. Resend renvoie un identifiant par message. Stockez-le à côté de l'identifiant du certificat pour retrouver un envoi perdu sans renvoyer le PDF à toute la promotion. La clé d'idempotence de l'API, valable 24 heures, évite les doublons lors d'un relancement.

Questions fréquentes#

Questions fréquentes

Faut-il un serveur pour générer les certificats ?

Non. Le script tourne sur un ordinateur portable et écrit les PDF dans un dossier. Un serveur devient nécessaire pour la page de vérification publique, l'envoi des e-mails et le stockage des fichiers si vous ne voulez pas garder votre machine allumée.

Peut-on éviter Python ?

Oui. Certifstudio propose un import CSV et une génération dans le navigateur. Typst permet d'écrire un template et de compiler en ligne de commande. Côté Node.js, des bibliothèques comme PDFKit ou pdf-lib produisent aussi des PDF, mais il faut alors écrire la mise en page et le QR à la main.

Comment empêcher la falsification d'un certificat ?

Un identifiant aléatoire, un registre privé et une page de vérification sur votre domaine. Le QR renvoie vers cette page, qui compare l'identifiant au registre et affiche le statut. Un simple hash dans le PDF ne suffit pas : il faut que le vérificateur fasse confiance à votre registre. Pour une preuve portable, signez une assertion Open Badges 3.0.

Combien de certificats peut-on générer par minute ?

Cela dépend de la taille de l'image de fond, de la police et du disque. Mesurez avec time python generate.py sur votre machine plutôt que de vous fier à un chiffre universel. Le facteur limitant est souvent l'envoi des e-mails, pas le rendu PDF.

Peut-on envoyer les certificats avec l'offre gratuite de Resend ?

Oui, dans la limite de 3 000 e-mails par mois et 100 par jour. Une promotion de 500 apprenants demande donc cinq jours d'envoi, ou le forfait Pro à 20 $ par mois pour 50 000 e-mails. L'API Batch accepte 100 messages par requête, mais ne contourne pas la limite quotidienne.

Un certificat de formation a-t-il une valeur officielle ?

Il atteste ce que votre organisme déclare : avoir suivi la formation, la durée et la date. Il ne remplace pas un titre professionnel enregistré ou une certification reconnue par l'État. Si la formation est financée, vérifiez les mentions exigées par le financeur et le cadre applicable avant de diffuser le modèle.

Sources#

Pages officielles, documentations et grilles tarifaires consultées le 7 novembre 2026. Les prix sont en euros ou en dollars US selon la devise affichée par l'éditeur.