Intégration & API

GiroCode pour développeurs & agences

Cette page s’adresse aux développeurs qui souhaitent intégrer des GiroCodes dans leurs projets, logiciels de facturation ou sites web.

Générer le payload EPC

Le payload EPC est un texte structuré ligne par ligne. L’exemple suivant illustre comment le générer en JavaScript/TypeScript :

function buildEPC({ name, iban, bic = '', amount, purpose = '' }) {
  const amountStr = amount ? 'EUR' + Number(amount).toFixed(2) : '';
  return [
    'BCD', '001', '1', 'SCT',
    bic.trim(),
    name.trim().slice(0, 70),
    iban.replace(/\s+/g, '').toUpperCase(),
    amountStr,
    '', '',
    purpose.trim().slice(0, 140)
  ].join('\n');
}

Générer un code QR à partir du payload

Avec le paquet qrcode (npm) vous pouvez dessiner le code QR :

import QRCode from 'qrcode';

const payload = buildEPC({
  name: 'Max Mustermann',
  iban: 'DE89370400440532013000',
  amount: 99.99,
  purpose: 'Facture 2025-001'
});

QRCode.toCanvas(canvas, payload, {
  errorCorrectionLevel: 'M',
  width: 220
});

Utiliser ce générateur

Vous pouvez créer un lien vers ce générateur ou l’utiliser comme implémentation de référence. Le code source complet est consultable publiquement.

Ouvrir le GiroCode Generator

Contact pour des coopérations

Vous êtes une agence ou un éditeur de logiciel et souhaitez coopérer ? N’hésitez pas à m’écrire : kontakt@girocodegenerator.com