ComusThumbz Documentation
Admin Login

Log di fatturazione

Cosa fa questa pagina

Questa pagina ti mostra un record di tutto ciò che accade tra il tuo sito e i tuoi fornitori di pagamento. Ogni volta che un pagamento viene elaborato, un abbonamento viene rinnovato, o qualcosa va storto con una transazione, viene registrato qui. Utilizzare questa pagina per verificare che i pagamenti funzionino correttamente e per indagare su eventuali problemi.

[Screenshot: page-overview]


Come arrivare qui

Navigare per Pannello di amministrazione > Fatturazione > Logs


Comprendere la pagina

Quando apri questa pagina, vedrai quattro aree principali: una barra statistica in alto, una serie di filtri sotto di essa, la tabella di registro principale e i pulsanti di navigazione in basso.

Statistiche Bar

Nella parte superiore della pagina, quattro carte colorate ti danno un rapido riassunto della tua attività di log:

Carta cartaCosa mostra
Log totaliIl numero totale di voci di registro (accento verde)
Messaggi DebugRecord di attività di sfondo dettagliato (accento grigio)
Info MessaggiMessaggi operativi normali come i pagamenti di successo (accento blu)
Messaggi di erroreProblemi che hanno bisogno della vostra attenzione (accento rosso)
Mancia: Tieni d'occhio il conteggio dei messaggi di errore. Su un sito sano, gli errori dovrebbero compensare meno del 5% dei registri totali. Se vedi errori arrampicarsi, indaga subito.

[Screenshot: billing-logs-stats]

Pannello di filtro

Sotto la barra delle statistiche, troverete filtri che consentono di restringere le voci di registro che vedete. È possibile filtrare tramite fornitore di pagamento, tipo di messaggio, una ricerca di parole chiave e un intervallo di date. Ulteriori dettagli sull'utilizzo dei filtri sono nella sezione Compiti comuni qui sotto.

Tabella di registrazione

L'area principale della pagina è una tabella che elenca ogni voce di registro, con le voci più recenti in alto. Ogni riga mostra:

ColonnaCosa mostra
IDUn numero unico per la voce di registro
Data/oraQuando l'evento è accaduto
FornitoreQuale fornitore di pagamento è stato coinvolto
TipoSe l'ingresso è un messaggio Debug, Info o Errore
MessaggioUn breve riassunto di quello che è successo
DettagliUlteriori informazioni (splendere su questa colonna per vedere il contenuto completo)

Le righe sono codificate a colori in modo da poter individuare rapidamente i problemi:

  • Sfondo rosso -- Errori che potrebbero aver bisogno della vostra attenzione
  • Sfondo grigio -- Entrate Debug con dettagli tecnici di sfondo
  • Sfondo bianco -- Normale voce informativa

Nota: Se un messaggio nella colonna Dettagli sembra tagliato, saltare il mouse sopra di esso. Il contenuto completo si espanderà in modo da poterlo leggere senza lasciare la pagina.

Pulsanti d'azione

Nella parte inferiore della pagina, troverete pulsanti di accesso rapido per passare a pagine correlate.


Compiti comuni

Come visualizzare i registri recenti

  1. Vai a Pannello di amministrazione > Fatturazione > Logs.
  2. La pagina mostra automaticamente le voci più recenti prima.
  3. Scorrere attraverso la tabella per rivedere l'attività.
  4. Hover sopra il Dettagli colonna su qualsiasi riga per vedere i dettagli completi di tale voce.

Come Filtrare dal Fornitore di Pagamento

Utilizzare questo quando si desidera vedere l'attività da un solo fornitore di pagamento (ad esempio, solo PayPal o solo Stripe).

  1. Selezionare il fornitore dal Fornitore di pagamento A terra.
  2. Fare clic Applicare filtri.
  3. La tabella e le schede statistiche aggiornano per mostrare solo le voci da quel fornitore.

Mancia: Questo è particolarmente utile quando si è problemi di risolvere un problema con un fornitore di pagamento specifico.

Come Filtrare per Tipo di Messaggio

Utilizzare questo per concentrarsi su un tipo specifico di voce di registro.

  1. Selezionare un tipo dal Tipo di messaggio a discesa:
  • Debug -- Dettagli tecnici dello sfondo
  • Info -- Eventi normali come pagamenti di successo
  • Errore - Problemi che hanno bisogno di attenzione
  1. Fare clic Applicare filtri.

Mancia: Per verificare rapidamente i problemi, impostare il Tipo di messaggio a Errore e rivedere quello che arriva.

Come Filtrare per Data Range

Utilizzare questo per guardare i registri da un periodo di tempo specifico.

  1. Fare clic su Data da campo e scegliere una data di inizio.
  2. Fare clic su Data a campo e scegliere una data di fine.
  3. Fare clic Applicare filtri.
  4. La tabella mostra solo le voci dall'interno dell'intervallo di date (entrambi le date sono completamente incluse).

Come Ricercare i Tronchi

Utilizzare questo quando si sta cercando qualcosa di specifico, come una parola chiave particolare o un numero di riferimento.

  1. Digitare il termine di ricerca nel Messaggi di ricerca campo.
  2. Fare clic Applicare filtri.
  3. I risultati mostrano le voci in cui il termine di ricerca appare nel messaggio o nei dettagli.

Termini di ricerca utili per provare:

Ricerca perPer trovare
webhookSpese di notifica di pagamento
failedOperazioni che non hanno completato
subscriptionEventi correlati all'iscrizione
amountLe voci menzionano gli importi di pagamento

Come Combinare Filtri multipli

È possibile utilizzare tutti i filtri allo stesso tempo per una ricerca molto mirata.

  1. Seleziona una Fornitore di pagamento.
  2. Seleziona una Tipo di messaggio.
  3. Impostare un Data da e Data a gamma.
  4. Digitare una parola chiave Messaggi di ricerca.
  5. Fare clic Applicare filtri.

Verranno visualizzate solo voci corrispondenti a tutti i criteri e le schede statistiche si aggiorneranno per corrispondere.

Come Cancellare Tutti i Filtri

  1. Fare clic su Ripristino pulsante accanto al pulsante Applica filtri.
  2. La pagina ricarica tutte le voci di registro senza filtri applicati.

Navigare tra le pagine

La tabella di registro mostra 100 voci per pagina. Se si dispone di più voci di questo, utilizzare la navigazione della pagina sotto la tabella per spostarsi tra le pagine. Vedrai Precedente e Il prossimo frecce con numeri di pagina. Una linea sotto la navigazione ti dice quale pagina sei e quante voci esistono in totale.

Nota: I filtri rimangono attivi mentre si sposta tra le pagine. Non è necessario riapplicarli.


Nella parte inferiore della pagina, tre pulsanti consentono di saltare in aree correlate:

PulsanteDove ti porta
Gestione dei providerLa pagina in cui si configurano i fornitori di pagamento
Gestione dei pacchettiLa pagina in cui si impostano i pacchetti di abbonamento e accesso
Visualizza le transazioniLa pagina che mostra le singole transazioni di pagamento

Consigli per i nuovi utenti

Mancia:
  • Controlla i registri di fatturazione almeno una volta al giorno, soprattutto quando hai impostato un nuovo fornitore di pagamento.
  • Un improvviso picco di messaggi di errore di solito significa qualcosa cambiato con il vostro fornitore di pagamento -- controllare le impostazioni del fornitore.
  • Utilizzare il filtro data range per confrontare la settimana di attività in settimana e individuare modelli insoliti.
  • Se si vede un nome del fornitore che mostra come un numero invece di un nome, significa che il fornitore è stato rimosso dalle impostazioni, ma i suoi vecchi registri esistono ancora. Questo è normale e niente di cui preoccuparsi.


Monitoraggio della tua salute di pagamento

Ecco un programma semplice per mantenere i pagamenti in esecuzione senza intoppi:

Quanto spessoCosa controllare
QuotidianoGuarda il numero di errori -- ci sono nuovi errori nelle ultime 24 ore?
QuotidianoGlance al volume di registro generale -- è il tuo sito di registrazione pagamenti come previsto?
SettimanaleConfronta il tasso di errore di questa settimana per la settimana scorsa -- sta salendo o verso il basso?
MensileVerificare l'attività di ciascun fornitore di pagamento per assicurarsi che stiano tutti lavorando

Capire i tassi di errore

Tasso di erroreChe cosa significaCosa fare
Meno dell'1%Tutto è sanoContinuare il monitoraggio normale
1% al 5%Problemi minori possono esistereGuarda gli errori e vedi se c'è un modello
5% al 10%Qualcosa ha bisogno di attenzioneVerificare gli errori immediatamente e controllare le impostazioni del provider
Più del 10%Problemi graviSmettere e indagare prima che influisca sui vostri ricavi
Attenzione: Se il tasso di errore salta improvvisamente sopra il 10%, controlla subito le impostazioni del fornitore di pagamento. Le cause comuni includono le credenziali scadute, gli indirizzi webhook modificati o le interruzioni dei fornitori.

Riconoscere i modelli di log comuni

Un pagamento di successo sembra questo

Vedrete una serie di messaggi Info in ordine:

  1. Una notifica ricevuta dal fornitore di pagamento
  2. La notifica verificata con successo
  3. Una transazione creata per l'utente
  4. L'abbonamento o l'accesso aggiornato

Successo: Quando vedi questo modello, il sistema di pagamento funziona correttamente.

Un pagamento fallito sembra questo

Vedrete uno o più messaggi di errore, spesso con un messaggio Info prima o dopo:

  1. Una notifica ricevuta dal fornitore di pagamento
  2. Un errore che indica ciò che è andato storto (come "il pagamento è diminuito" o "la verifica è fallita")

Cosa fare quando vedi errori

  1. Filtra per Tipo di messaggio: Errore vedere tutti gli errori recenti.
  2. Cercare modelli -- sono gli errori tutti dallo stesso fornitore? Lo stesso tipo di messaggio?
  3. Hover sopra il Dettagli colonna per maggiori informazioni su ogni errore.
  4. Prendere azione in base a ciò che si trova:
Modello di erroreCosa fare
"chiave API non valide" o "firma fallita"Vai alle impostazioni del tuo fornitore di pagamento e verifica che le tue credenziali siano corrette
"Pagamento declinato"Questo è normale -- significa che il metodo di pagamento del cliente è stato respinto dalla loro banca
"Connessione timeout"Di solito è temporaneo. Se continua a succedere, il server potrebbe avere un problema di connettività -- contattare il provider di hosting
"User not found"Un pagamento è arrivato per un account utente che non esiste. Controllare se l'account del cliente è stato cancellato

Risoluzione dei problemi

Nessuna registrazione viene visualizzata

Cosa vedi: La pagina carica ma la tabella è vuota e tutte le statistiche mostrano zero.

Come risolvere il problema:

  1. Assicurarsi di avere almeno un fornitore di pagamento impostato. Vai a Pannello di amministrazione > Fatturazione > Fornitori di pagamento e controlla.
  2. Se hai appena impostato i tuoi fornitori di pagamento, i registri verranno visualizzati solo dopo che si verifica un'attività di pagamento reale (una transazione di prova, un webhook dal tuo fornitore, ecc).
  3. Controlla che i filtri non siano troppo restrittivi. Fare clic Ripristino per cancellare tutti i filtri e vedere se le voci appaiono.

La colonna Dettagli non si espande quando hover sopra di esso

Cosa vedi: Si accumula sopra una voce troncata nella colonna Dettagli ma non si espande.

Come risolvere il problema:

  1. Prova a rinfrescare la pagina.
  2. Prova un browser web diverso per vedere se il problema persiste.
  3. Se la voce mostra "Nessun dettaglio aggiuntivo", non c'è niente di più da vedere per quella voce -- semplicemente non ha ulteriori informazioni di dettaglio.

Un fornitore di pagamento mostra un numero invece di un nome

Cosa vedi: Nella colonna Provider, si vede un numero (come "3") invece di un nome del fornitore.

Come risolvere il problema:
Questo accade quando un fornitore di pagamento è stato rimosso dalle impostazioni, ma le sue voci di registro esistono ancora. I registri sono ancora validi -- il sistema non può più cercare il nome del fornitore. Questo non influisce sul funzionamento del sito.

I filtri non sembrano funzionare

Cosa vedi: Si applicano filtri ma i risultati non sembrano corretti.

Come risolvere il problema:

  1. Fare clic Ripristino per cancellare tutti i filtri.
  2. Applicare un solo filtro alla volta per restringere il filtro che potrebbe causare confusione.
  3. Controlla il tuo range di date -- assicurati che il Data da è prima Data a.


PaginaQuando usarlo
Fornitori di pagamentoPer impostare o modificare le impostazioni del processore di pagamento (credentials, indirizzi webhook, ecc.)
Fatturazione TransazioniPer vedere le singole transazioni di pagamento, i rimborsi e le spese di abbonamento
Pacchetti di accessoPer creare o modificare i piani di abbonamento e le opzioni di acquisto una volta disponibili sul tuo sito