La riconciliazione pagamenti di un e-commerce collega ogni movimento economico al suo passaggio successivo: ordine, pagamento, eventuale rimborso, saldo del provider e accredito bancario. Confrontare vendite di lunedì e bonifico di lunedì non basta: il bonifico può contenere operazioni di giorni diversi e arrivare al netto di altre voci.
Prima di cercare una differenza, scegli lo stesso perimetro: provider, valuta, lotto di accredito e stato dei movimenti. Nell’esempio ipotetico, 1.000 euro incassati meno 100 euro di rimborsi e 25 euro di commissioni producono 875 euro, assumendo che non esistano altre rettifiche. I 25 euro sono un dato inventato per spiegare il conto, non una tariffa di mercato.
Tre confronti diversi, tre domande diverse
Il primo controllo riguarda ordine e pagamento: il cliente ha pagato quanto previsto? Il secondo collega le operazioni al saldo del provider: quali movimenti compongono la disponibilità? Il terzo segue l’accredito fino alla banca: il trasferimento atteso è arrivato e con quale riferimento?
Un ordine può essere pagato in più parti; un pagamento può ricevere rimborsi parziali in date successive; un accredito può raggruppare centinaia di movimenti. Una sola colonna «pagato sì/no» non rappresenta queste relazioni. È utile mantenere identificatori distinti e legami espliciti.
| Livello | Riferimento da conservare | Anomalia da spiegare |
|---|---|---|
| Ordine | ID del negozio | Importo o valuta discordante |
| Pagamento | ID del provider | Pagamento senza ordine associato |
| Movimento | ID contabile del provider | Commissione o rettifica non classificata |
| Accredito | ID del trasferimento | Somma del lotto diversa dall’atteso |
| Banca | Riferimento del movimento | Accredito non ancora riconosciuto |
Un indirizzo email o il nome del cliente non sono chiavi affidabili: possono cambiare o ricorrere in più acquisti. Usa i riferimenti tecnici già presenti e conserva la provenienza del dato.
Ricostruire 875 euro senza forzare il risultato
Riprendi il lotto ipotetico: pagamenti 1.000 euro, rimborso 100, commissioni complessive 25. Il prospetto atteso mostra 875 euro. Se in banca ne trovi 850, resta una differenza di 25: non creare una voce generica «commissioni» soltanto per chiudere il conto.
Cerca il movimento che spiega la differenza. Potrebbe trattarsi di una rettifica, una voce appartenente a un altro periodo o un confronto tra perimetri sbagliati; sono ipotesi, non diagnosi. Finché manca il riferimento, lascia l’anomalia aperta con responsabile e prossimo controllo.
Nella documentazione di Stripe sulla riconciliazione degli accrediti, il report collega transazioni e accrediti automatici. Per accrediti manuali Stripe rimanda al report del saldo; gli accrediti istantanei non consentono la stessa associazione automatica del lotto. Prima di costruire un connettore, verifica quindi quale modalità usa davvero l’account.
Rimborso deciso, eseguito e regolato sono momenti diversi
Il servizio clienti può autorizzare un reso prima che il provider esegua il rimborso. Poi il movimento può incidere su un saldo o accredito successivo. Se il gestionale considera tutti questi eventi equivalenti, rischia di segnare come restituito un importo ancora in attesa.
Mantieni il riferimento del rimborso e collegalo al pagamento originale, anche quando è parziale. Mostra importo richiesto, stato del provider e importo confermato. La decisione operativa sul reso appartiene al flusso RMA dell’e-commerce; questa guida segue invece la traccia economica dopo quella decisione.
Anche una contestazione è un evento distinto da un rimborso volontario. Classifica i movimenti secondo i dati del provider e il processo approvato dall’amministrazione, evitando di nascondere tutto sotto una sola etichetta «reso».
Il falso errore causato dal calendario
Data dell’ordine, creazione del pagamento, disponibilità del saldo e arrivo in banca possono essere diverse. Aggiungi il fuso orario: un evento serale può cadere nel giorno successivo in un’esportazione UTC. Due file con lo stesso intervallo scritto nel nome possono dunque non coprire le stesse operazioni.
Registra data e significato del campo, non solo il valore. Per confronti giornalieri concorda il fuso; per chiudere un accredito usa il suo identificatore e i movimenti associati. Se il provider non fornisce quella relazione, dichiara il limite e usa una procedura di controllo adatta, invece di inventare un abbinamento per somiglianza.
La valuta va trattata allo stesso modo: separa valuta del pagamento e valuta dell’accredito. Un eventuale cambio richiede dati e criteri verificabili. Non sommare importi di valute diverse in un unico totale senza mostrare la conversione.
Una coda delle eccezioni, non un muro di righe rosse
Propongo quattro gruppi operativi: ordine senza pagamento confermato, movimento senza collegamento, differenza nel lotto e accredito bancario da verificare. Ogni riga dovrebbe mostrare importo, anzianità, fonte e persona incaricata. Un operatore deve poter capire cosa fare senza aprire cinque pannelli.
Un abbinamento manuale deve lasciare traccia. Se viene annullato, conserva motivo e collegamento precedente; non riscrivere lo storico come se l’errore non fosse mai esistito. Per ridurre lavoro ripetuto, una regola automatica può suggerire associazioni, ma va provata sui casi ambigui prima di chiudere differenze senza revisione.
Collaudare il collegamento prima di automatizzare
- Importa due volte lo stesso file: il saldo non cambia alla seconda importazione.
- Simula due pagamenti dello stesso importo: il sistema non li confonde.
- Aggiungi un rimborso parziale al mese successivo: resta legato all’operazione originale.
- Introduci una rettifica non classificata: compare come eccezione, non sparisce nel totale.
- Interrompi l’aggiornamento a metà: la ripresa non duplica movimenti.
- Confronta un lotto in euro e uno in altra valuta: i totali restano separati.
- Esporta un accredito chiuso: ogni riga conserva riferimento e fonte.
Con pochi movimenti può bastare un prospetto controllato. Un’integrazione diventa utile quando la ripetizione e il numero di fonti rendono fragile il lavoro manuale. Definisci prima il contratto tra le API e le eccezioni; poi valuta un modulo esistente o uno sviluppo mirato. Misura differenze irrisolte e tempo necessario a chiudere un lotto, non soltanto righe importate.
Domande frequenti
Perché il bonifico è inferiore alle vendite?
Può includere commissioni, rimborsi, rettifiche o operazioni di un altro periodo. La causa va ricostruita dai movimenti del lotto, senza attribuire automaticamente tutta la differenza alle commissioni.
Basta confrontare il totale giornaliero?
No. Date e perimetri possono differire. Occorre identificare pagamenti, movimenti e accrediti, mantenendo separati valuta e significato delle date.
Un rimborso parziale chiude l’ordine?
Non necessariamente. Il rimborso va collegato al pagamento con il proprio importo e stato; la gestione commerciale dell’ordine e del reso segue regole distinte.
Serve un nuovo gestionale completo?
Spesso basta collegare fonti già esistenti e organizzare le eccezioni. La scelta dipende dai report disponibili e dai casi che gli strumenti attuali non riescono a spiegare.
Fonti e verifica
Consultata il 19/09/2026: Stripe, Payout reconciliation. Limiti dei report riferiti a Stripe, non estesi automaticamente ad altri provider. Modello operativo, tabella e numeri sono esempi originali; nessuna tariffa o promessa di recupero economico.