GiroCode per Sviluppatori

Generare il payload EPC

Il payload EPC è un testo strutturato per righe. La seguente funzione mostra come generarlo in 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');
}

Creare un codice QR dal payload

Con il pacchetto qrcode di npm puoi disegnare il QR a partire dal payload:

import QRCode from 'qrcode';

const payload = buildEPC({
  name: 'Mario Rossi',
  iban: 'IT60X0542811101000000123456',
  amount: 99.99,
  purpose: 'Fattura 2025-001'
});

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

API in Arrivo

L'API REST GiroCode è attualmente in fase beta. Iscriviti per ricevere accesso anticipato e la documentazione completa.