API Reference

API semplice. Potente.

Una chiamata POST /checkout/ref con i dati del cliente e i prodotti acquistati. Aggiungi il fj_ref ai metadata del PaymentIntent Stripe — Fisco Jet fa il match e genera la fattura automaticamente.

Ottieni la tua API key →Documentazione completa

Quick start

Passo 1 — Crea il checkout ref (tuo backend)

curl -X POST https://api.fiscojet.com/checkout/ref \
  -H "Authorization: Bearer fj_live_sk_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      { "uuid": "prod_e0dd538f1d51", "qty": 1 }
    ],
    "billing": {
      "nome": "Mario Rossi S.r.l.",
      "piva": "IT18227661008",
      "sdi": "XXXXXXX",
      "indirizzo": "Via Roma 1",
      "citta": "Milano",
      "cap": "20121"
    }
  }'

Response 201

{
  "error": false,
  "success": true,
  "data": {
    "ref": "fj_ref_4a3b2c1d9e8f7a6b"
  }
}

Passo 2 — Aggiungi il ref al PaymentIntent Stripe

const paymentIntent = await stripe.paymentIntents.create({
  amount: 12200,
  currency: 'eur',
  metadata: {
    fj_ref: 'fj_ref_4a3b2c1d9e8f7a6b'
  }
});
// Fisco Jet fa il match automaticamente
// e genera la fattura al completamento.

Endpoints

POST/checkout/refCrea un checkout reference con dati cliente e prodotti

GET/checkout/ref/:uuidRecupera stato e dati di un checkout reference

POST/webhooks/openapiNotifiche SDI in entrata (configura l'URL nella dashboard)

Autenticazione

Fisco Jet usa API key Bearer per autenticare le chiamate server-side. Genera la tua chiave dalla sezione Sviluppatore della dashboard — puoi rigenerarla in qualsiasi momento.

→ Prefisso fj_live_sk_ per le chiavi di produzione
→ Generazione e revoca istantanea dalla dashboard
→ La chiave viene mostrata una sola volta al momento della creazione
→ Autenticazione richiesta su tutti gli endpoint /checkout/*

Header richiesto

Authorization: Bearer fj_live_xxxxxxxxxxxx

Webhooks

Fisco Jet riceve le notifiche SDI tramite il tuo endpoint webhook /webhooks/openapi e aggiorna lo stato delle fatture in tempo reale. L'URL da registrare presso il tuo provider SDI è visibile nella dashboard.

invoice.deliveredFattura consegnata con successo al destinatario

invoice.rejectedFattura rifiutata dall'SDI — messaggio di errore incluso

invoice.errorErrore tecnico durante l'elaborazione

Pronto in 5 minuti

Fisco Jet è un'API REST standard: funziona con qualsiasi linguaggio o framework che supporti chiamate HTTP.

Node.jsPythonPHPRubyGoJavacURL