Come viene fattilizzato l’utilizzo dell’API?

L’API di Cathopic utilizza un modello di fatturazione “pay-as-you-go” basato sull’utilizzo effettivo dei contenuti da parte dei tuoi utenti finali. Tutti i termini di fatturazione sono regolati dal nostro Accordo di licenza per l’API.

Due modelli di fatturazione

La fatturazione dipende da come i tuoi utenti finali consumano i contenuti:

1. Utilizzo sul sito web (modello “Days of Use”)

• Si applica quando i contenuti vengono visualizzati su siti web, blog o applicazioni web

• Viene calcolato per ogni giorno di calendario in cui un utente finale accede a contenuti specifici

• Formula: Totale giorni di utilizzo × (tariffa mensile concordata ÷ 30)

• La fatturazione giornaliera pro-rata garantisce che tu paghi solo l’utilizzo effettivo

• Tracciato separatamente per ogni utente finale e per ogni singolo elemento di contenuto

2. Utilizzo via email (modello “Per Email”)

• Si applica quando i contenuti vengono incorporati nei messaggi email

• Addebitato per ogni messaggio email inviato (non per destinatario)

• Fatturazione una tantum per email che include il contenuto

• Tariffa concordata durante la configurazione dell’accesso all’API

Come iniziano e si interrompono le fatturazioni

I contenuti con filigrana sono gratuiti

• Il contenuto appare inizialmente con una filigrana

• L’anteprima con filigrana non genera addebiti

• Ideale per consentire agli utenti finali di consultare prima di impegnarsi

• Può essere usato per test e finalità di prova

La fatturazione inizia quando la filigrana viene rimossa

1. L’utente finale decide di utilizzare il contenuto senza filigrana

2. La tua applicazione chiama POST /confirm con:

   • media_id: l’identificatore del contenuto

   • usage_type: “website” oppure “email”

   • client_identifier: l’ID univoco del tuo utente finale

3. L’API restituisce URL permanenti per i contenuti senza filigrana

4. La fatturazione inizia immediatamente da questo momento

5. Devi memorizzare questi URL e i dati di utilizzo per il tracciamento della fatturazione

La fatturazione si interrompe quando il contenuto viene rimosso

1. L’utente finale rimuove o smette di utilizzare il contenuto

2. La tua applicazione chiama POST /remove con:

   • media_id: l’identificatore del contenuto

   • client_identifier: l’ID dell’utente finale

3. La fatturazione per quello specifico utilizzo si interrompe

4. Devi eliminare dal tuo database gli URL dei contenuti senza filigrana

Esempio di fatturazione per sito web

Supponiamo che tu abbia concordato una tariffa mensile di per un utilizzo illimitato dei contenuti:

• Scenario: La Parrocchia A visualizza l’Immagine n. 12345 nella homepage

• Giorno 1: chiami /confirm → inizia la fatturazione

• Giorni 1-15: l’Immagine rimane nella homepage (15 giorni di utilizzo)

• Giorno 16: la Parrocchia rimuove l’immagine, chiami /remove → la fatturazione si interrompe

• Calcolo: 15 giorni × ( ÷ 30 giorni) =

• Addebitato: per questo specifico utilizzo

Se anche la Parrocchia B usa la stessa immagine per 10 giorni, viene tracciato separatamente e si aggiunge altro.

Esempio di fatturazione via email

Supponiamo che tu abbia concordato una tariffa di --.05 per email:

• Scenario: Un Dicastero invia una newsletter con l’Immagine n. 67890

• Azione: chiami /confirm con usage_type: "email"

• Risultato: addebito una tantum di --.05 per quella email

• Destinatari: non importa se viene inviata a 100 o a 10.000 persone

• Addebitato: --.05 totale (non per destinatario)

Limiti mensili di fatturazione

Il tuo accordo può includere limiti mensili di fatturazione:

• Ti protegge da bollette inaspettatamente alte

• Una volta raggiunto il limite, l’utilizzo aggiuntivo può essere gratuito o a tariffa ridotta

• L’importo specifico del limite viene concordato durante la configurazione dell’accesso all’API

• Si applica al totale degli addebiti mensili su tutti gli utenti finali

Fatturazione e pagamento

Programma delle fatture

• Le fatture vengono emesse mensilmente entro i primi 10 giorni di ogni mese

• Coprono tutto l’utilizzo del mese precedente

• Dettaglio dell’utilizzo per utente finale e per singolo elemento di contenuto

• Inviate all’indirizzo email associato al tuo account API

Elaborazione dei pagamenti

• I pagamenti vengono elaborati esclusivamente tramite Stripe

• Addebito automatico sul metodo di pagamento registrato

• Devi mantenere sempre informazioni di pagamento valide

• Le ricevute vengono fornite automaticamente dopo un pagamento riuscito

Fallimenti di pagamento

• Se il pagamento non va a buon fine, il sistema effettua 4 tentativi di recupero

• Ricevi notifiche via email riguardo ai problemi di pagamento

• Se tutti i tentativi falliscono, l’accesso all’API viene sospeso

• L’accesso viene ripristinato immediatamente dopo un pagamento riuscito

• Le fatture non pagate possono accumulare interessi

Le tue responsabilità di tracciamento

Devi mantenere registri accurati di:

• Log di utilizzo: quando il contenuto è stato confermato e rimosso

• ID degli utenti finali: quali utenti hanno accesso a quali contenuti

• ID dei contenuti: quali elementi multimediali sono stati usati

• Tipi di utilizzo: sito web vs email per ogni utilizzo

• Date: data di inizio e data di fine per l’utilizzo sul sito web

• URL: URL senza filigrana memorizzati per l’utilizzo attivo

Questi log sono essenziali per:

• Verificare le fatture mensili

• Risoluzione delle controversie di fatturazione

• Audit di conformità da parte di Cathopic

• La tua reportistica interna

Accedere ai report di utilizzo

Puoi monitorare l’utilizzo della tua API in tempo reale:

1. Vai su Impostazioni → API

2. Visualizza la sezione “Utilizzo on-demand”

3. Consulta le statistiche del periodo di fatturazione corrente:

   • Costo totale accumulato finora

   • Numero di utilizzi sul sito web

   • Numero di utilizzi via email

4. Clicca “Visualizza report dettagliato” per il dettaglio per:

   • Utente finale (client identifier)

   • Elemento di contenuto

   • Tipo di utilizzo

   • Intervallo di date

   • Costi individuali

5. Esporta i report in formato CSV per i tuoi archivi

Concordare le tariffe

Il prezzo dell’API è personalizzato per ogni cliente:

• Le tariffe vengono concordate durante il processo di richiesta di accesso all’API

• In base al volume di utilizzo previsto

• In base al tuo caso d’uso specifico e al tipo di integrazione

• Può includere sconti sul volume per applicazioni ad alto utilizzo

• I limiti di fatturazione possono essere concordati per fornire costi prevedibili

Per discutere i prezzi:

1. Visita la nostra pagina di supporto

2. Seleziona “API access request”

3. Descrivi la tua integrazione e l’utilizzo previsto

4. Il nostro team fornirà un preventivo personalizzato

Comprendere l’intera licenza

La fatturazione è solo un aspetto dell’accordo relativo all’API. Rivedi i termini completi:

• Leggi l’Accordo di licenza per l’API completo

• Comprendi le restrizioni d’uso (solo digitale, niente AI/ML, niente download)

• Conosci i tuoi obblighi per il tracciamento e la rendicontazione

• Rivedi le clausole su proprietà intellettuale e risoluzione

Per dettagli tecnici sull’implementazione:

• Consulta gli endpoint /confirm e /remove su api.cathopic.com/docs

• Comprendi come calcolare l’utilizzo per la tua integrazione specifica

• Rivedi le migliori pratiche per un tracciamento della fatturazione accurato

Ricorda: il tracciamento accurato dell’utilizzo è una tua responsabilità. Mantieni log dettagliati per garantire una fatturazione corretta e la conformità all’accordo di licenza.