Vai al contenuto

Riconciliazione e reportistica

Trasforma le transazioni in un registro finanziario utilizzabile.

I report del Business Portal con export in XLS, le API di saldo e attività e i webhook firmati danno al team finance un registro dettagliato di ogni incasso, payout e conversione, in ogni paese in cui operi.

  • Report esportabili in XLS
  • API di saldo, attività e riconciliazione
  • Webhook firmati HMAC
Report principali nel Business Portal
5
Registro giornaliero dei movimenti del tuo conto
FIDES
Invio programmato dei report
SFTP · email
Report via API o dal Business Portal
API + Portal

Perché conta

Un’unica fonte di verità per finance e operations

Incassi, payout, conversioni e commissioni di tutti i paesi confluiscono negli stessi report e nelle stesse API, con gli identificativi che i tuoi sistemi già usano.

  • Dettaglio per transazione

    Ogni transazione riporta externalId, internalId, stato, importi e commissioni e, se c’è una conversione, il tasso di cambio applicato.

  • Ogni paese, un solo formato

    Gli stessi report ed endpoint per ogni mercato e circuito, così aggiungere un paese non aggiunge un nuovo processo di riconciliazione.

  • Saldi verificabili

    Visualizza saldo e saldo previsto per ogni conto e riconcilia i movimenti con l’API di riconciliazione del saldo.

  • Trova qualsiasi transazione

    Cerca una transazione per externalId, controllane lo stato oppure elenca e filtra le transazioni con paginazione.

  • Webhook in tempo reale

    Notifiche firmate HMAC per incassi, conti virtuali, payout, operazioni di cambio e Wire In o Out, ritentate se il tuo endpoint non risponde 200.

  • Invio programmato

    Programma l’invio dei report di saldo, FIDES, dettaglio, attività o consolidamento globale via email o SFTP: giornaliero, settimanale o mensile, in XLS o CSV.

Report del Business Portal

I report più usati dal team finance

Generali nel Business Portal ed esportali in XLS per il tuo ERP, i tuoi fogli di calcolo o i tuoi revisori.

  • Saldo

    Cosa mostra
    Saldo attuale per conto e valuta
    Uso tipico
    Posizione di cassa giornaliera
  • Saldo previsto

    Cosa mostra
    Saldo atteso, inclusi i movimenti ancora in corso
    Uso tipico
    Pianificazione di payout e finanziamenti
  • Attività

    Cosa mostra
    Accrediti e addebiti su un conto in un periodo
    Uso tipico
    Abbinamento dei movimenti al tuo libro contabile
  • Dettaglio transazioni

    Cosa mostra
    Ogni transazione con identificativi, stato, importi e commissioni
    Uso tipico
    Riconciliazione per ordine e assistenza clienti
  • FIDES

    Cosa mostra
    Registro giornaliero dei movimenti del conto
    Uso tipico
    Chiusura giornaliera e audit trail

Descrizioni sintetiche. Consulta la guida alla reportistica su docs.localpayment.com per i campi esatti di ogni report.

Come funziona

Dalla transazione alla chiusura dei conti

  1. Identifica ogni transazione

    Invia un tuo externalId univoco con ogni incasso, payout o conversione. Localpayment restituisce un internalId per lo stesso record.

  2. Ricevi le notifiche

    Un webhook firmato segnala ogni cambio di stato. Il tuo sistema verifica la firma, risponde 200 e aggiorna l’ordine.

  3. Abbina i saldi

    Confronta attività e saldi per conto tramite le API o i report del Business Portal, con dettaglio per transazione e valuta.

  4. Chiudi ed esporta

    Riconcilia con l’API di riconciliazione del saldo ed esporta i report in XLS per il tuo ERP e i revisori.

Webhook

Sappi subito quando cambia uno stato

I webhook si configurano per cliente nel Business Portal: un URL HTTPS, un paese o tutti, un conto e header personalizzati opzionali. Ogni payload è firmato, così puoi fidarti di ciò che arriva.

  • Firmati con HMAC-SHA256 nell’header X-Signature
  • Eventi per incassi, conti virtuali, abbonamenti, payout, operazioni di cambio, Wire In e Wire Out
  • Ritentati con backoff esponenziale se il tuo endpoint non risponde 200
  • Deduplica su internalId o externalId

Chi lo usa

Pensato per i team che chiudono i conti

Per gli sviluppatori

Una riconciliazione che puoi automatizzare

Recupera saldi, attività e transazioni con la stessa API REST che usi per i pagamenti, autenticata con un token Bearer. Testa ogni chiamata su Stage prima di andare live.

  • GET /api/accounts/{accountNumber}/balance, /activity e /balance-reconciliation
  • GET /api/transactions/{externalId} e /status
  • GET /api/transactions/list/filter, con paginazione
# Esempio illustrativo — consulta docs.localpayment.com per il contratto esatto
curl https://api.stage.localpayment.com/api/accounts/<your-account-number>/balance-reconciliation \
  -H "Authorization: Bearer $ACCESS_TOKEN"

# Elenca e filtra le transazioni (parametri illustrativi)
curl -G https://api.stage.localpayment.com/api/transactions/list/filter \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data-urlencode "since=2026-09-01" \
  --data-urlencode "until=2026-09-30" \
  --data-urlencode "page=1" \
  --data-urlencode "size=100"

Domande frequenti

Quali report sono disponibili nel Business Portal?

Saldo, saldo previsto, attività, FIDES e dettaglio transazioni. La maggior parte è esportabile in XLS; le esportazioni grandi vengono accodate nei report storici e i report delle notifiche li inviano via email o SFTP in modo programmato.

Posso riconciliare tramite API?

Sì. Gli endpoint di saldo, attività e riconciliazione del saldo funzionano per conto, e puoi recuperare una transazione, controllarne lo stato oppure elencare e filtrare le transazioni con paginazione.

Come abbino un pagamento a un ordine nel mio sistema?

Invia un tuo externalId univoco quando crei la transazione. Lo ritrovi nei webhook, nei report e nelle risposte API, accanto all’internalId assegnato da Localpayment.

Commissioni e cambio sono dettagliati?

Sì. I dati della transazione includono importo, valuta e commissioni e, se c’è una conversione, il tasso di cambio e l’importo in valuta locale.

Cosa succede se il mio endpoint webhook non è raggiungibile?

Le consegne vengono ritentate con backoff esponenziale se il tuo endpoint non risponde 200. Puoi anche interrogare l’API di stato delle transazioni in qualsiasi momento.

I report funzionano allo stesso modo in ogni paese?

Sì. Gli stessi report, endpoint e identificativi valgono in ogni paese e circuito in cui operi, così un nuovo mercato non comporta un nuovo processo di riconciliazione.

Posso scaricare i report automaticamente ogni giorno?

Sì. Gli endpoint di attività e riconciliazione dei saldi accettano intervalli di date, quindi un job pianificato può recuperare i movimenti di ieri e registrarli nella tua contabilità.

Fino a quando posso consultare le transazioni passate?

Usa filtri per data e paginazione nell’API di elenco transazioni. Nel Business Portal, le esportazioni oltre 15.000 righe vengono accodate e scaricate dai report storici.

Chiudi prima, con meno fogli di calcolo

Scopri come i report del Business Portal, le API di riconciliazione e i webhook si integrano nei tuoi processi finance.

Come possiamo aiutarti?

Scarica la tua copia

Lasciaci i tuoi dati e ricevi subito l’edizione completa.