Entità
Entità Addebito (Charge)
Comprendere le transazioni finanziarie, i costi una tantum e i metadati delle fatture.
Entità Addebito (Charge)
Un Charge (chiamato anche Transazione) rappresenta un saldo finanziario specifico associato a un Customer. Può essere generato automaticamente dal rinnovo di un abbonamento o creato manualmente per servizi una tantum.
Utilizzo
L'entità Charge viene utilizzata per:
- Processare pagamenti ad-hoc per costi di setup, consulenza o hardware.
- Archiviare lo storico degli eventi di fatturazione ricorrente.
- Gestire l'associazione con documenti legali (fatture e ricevute).
- Tracciare in tempo reale lo stato del pagamento (Pending, Paid, Refunded).
Flusso Atteso
Ciclo di vita di una transazione finanziaria manuale:
- Generazione: Crea l'oggetto charge con una o più righe di servizio.
- Esecuzione: Se il
captureè abilitato, il sistema utilizza il metodo di pagamento predefinito del cliente. - Adempimento: Dopo il successo, i dettagli formali della fattura vengono allegati per la sincronizzazione contabile.
Schema Dati
I campi che definiscono un oggetto Charge:
| Campo | Tipo | Descrizione |
|---|---|---|
id | eid | Identificativo univoco esteso. |
customer_id | string | Il proprietario della transazione. |
total | number | Totale netto della transazione (comprensivo di tasse). |
status | string | Stato corrente: pending, paid, refunded, failed. |
services | array | Elenco degli articoli addebitati con relativi profili fiscali. |
invoice | object | Metadati per la contabilità (numero, data, link esterno). |
date | object | Timestamp preciso dell'evento di creazione. |
Grafo delle Chiamate (Relationship)
Come i Charge interagiscono con i gateway di pagamento esterni: