Accedere ai dati dei pagamenti
Per trovare e visualizzare un pagamento in Dashboard:
- Vai a Dashboard -> Pagamenti.
- Seleziona il pagamento che desideri visualizzare. Se non appare immediatamente, filtra per data o importo per restringere la ricerca. La data è la data di arrivo del pagamento.
- Visualizza la panoramica del pagamento e l'elenco delle transazioni in Dashboard.
- Per maggiori dettagli, fai clic su Esporta transazioni per scaricare un file CSV di Riepilogo pagamenti o Dettagli pagamenti.
- Esportazione legacy: il formato di report legacy è ancora disponibile nella pagina del singolo pagamento fino al 31 luglio 2025, per agevolare la transizione ai nuovi report.
Più pagamenti
Per visualizzare informazioni su più pagamenti:
- Vai a Dashboard -> Pagamenti.
- Fai clic su Esporta in alto a destra.
- Seleziona il tipo di report preferito: Riepilogo pagamenti o Dettagli pagamenti.
- Modifica gli intervalli di date. Gli intervalli di date si basano sulla data della transazione dell'ordine, non sulla data di arrivo del pagamento.
- Fai clic su Genera report.
Panoramica del pagamento
La pagina del pagamento fornisce una visualizzazione di alto livello del pagamento, così puoi comprendere rapidamente i dettagli principali senza esportare un report.
Ogni pagamento è suddiviso in quattro componenti, quindi totalizzato:
- Pagamenti: transazioni per le quali sono stati ricevuti fondi.
- Rimborsi: transazioni per le quali i fondi sono stati restituiti.
- Addebiti: commissioni detratte dal pagamento, come commissioni di transazione o rettifiche.
- Accrediti: rimborsi applicati al pagamento, come rimborsi per commissioni addebitate in eccesso o altri accrediti emessi sul tuo account.
- Pagamento precedente non riuscito: se un pagamento precedente non è riuscito ed è stato successivamente inviato con un pagamento seguente, questa riga includerà tali dettagli.
Per ogni componente vengono visualizzati i seguenti dettagli:
- Articoli: l'importo totale pagato dagli acquirenti per i prodotti nel periodo di pagamento.
- Spedizione: l'importo totale pagato dagli acquirenti per la spedizione nel periodo di pagamento.
- Sconto: gli sconti totali applicati agli ordini nel periodo di pagamento.
- Dazi, imposte, commissioni: l'importo totale pagato dagli acquirenti per dazi, imposte e altre commissioni nel periodo di pagamento.
- Garanzia: l'importo totale riscosso da Zonos per coprire dazi, imposte e commissioni garantiti, che Zonos ha pagato per tuo conto. Questi costi sono garantiti da Zonos.
- Commissione di transazione: le commissioni totali per l'utilizzo dei servizi Checkout, inclusa la protezione antifrode (escluse le commissioni di elaborazione dei pagamenti).
- Commissione merchant: le commissioni totali di elaborazione dei pagamenti detratte dal pagamento.
- Altro: il totale di eventuali addebiti vari nel periodo di pagamento, con note che forniscono dettagli.
- Totale: il totale netto del pagamento.
Per maggiori dettagli, esporta il report CSV.
Transazioni in un pagamento
Ogni transazione inclusa nel pagamento è elencata nella sezione Transazioni. A colpo d'occhio, per ogni transazione sono disponibili i seguenti dettagli:
- Data: la data della transazione.
- Numero ordine: il numero dell'ordine Zonos associato alla transazione.
- Articoli: l'importo pagato dall'acquirente per i prodotti.
- Spedizione: l'importo pagato dall'acquirente per la spedizione.
- Sconto: eventuali sconti applicati all'ordine.
- Dazi, imposte, commissioni: l'importo pagato dall'acquirente per dazi, imposte e altre commissioni.
- Garanzia: l'importo riscosso da Zonos per coprire dazi, imposte e commissioni garantiti, che Zonos paga per tuo conto. Questi costi sono garantiti da Zonos.
- Commissione di transazione: la commissione per l'utilizzo dei servizi Checkout, inclusa la protezione antifrode (escluse le commissioni di elaborazione dei pagamenti).
- Commissione merchant: la commissione per l'elaborazione dei pagamenti.
- Altro: addebiti vari con una nota che ne spiega il motivo.
- Totale: il totale netto della transazione incluso nel pagamento.
Ripartizione delle commissioni Zonos per transazione
Fai clic sul numero dell'ordine di una transazione per visualizzare una ripartizione dettagliata, inclusi importi dei prodotti, costi di spedizione, dazi, imposte e commissioni dettagliate (i costi pass-through non verranno visualizzati). Se non vengono visualizzate commissioni, potrebbero non essere applicabili a quella transazione, ad esempio per rimborsi o ordini DDU.
Esportare report CSV
Puoi esportare due tipi di report: Riepilogo pagamenti e Dettagli pagamenti. Confrontali nella pagina Report scaricabili.
Esportare un singolo pagamento
Per esportare un CSV di un pagamento specifico:
- Vai a Dashboard -> Pagamenti
- Fai clic su un pagamento specifico
- Fai clic su Esporta transazioni in qualsiasi pagina dei pagamenti
- Scegli tra Riepilogo pagamenti e Dettagli pagamenti
- In questo modo vengono esportati i dati relativi solo a quel pagamento specifico
Più periodi di pagamento
Per esportare un CSV che comprende più periodi di pagamento:
- Vai a Dashboard -> Pagamenti
- Fai clic su Esporta in alto a destra
- Seleziona Riepilogo pagamenti o Dettagli pagamenti
- Scegli l'intervallo di date (in base alla data della transazione dell'ordine)
- Fai clic su Genera report
Nota: il formato di report legacy è ancora disponibile nelle pagine dei singoli pagamenti fino al 31 luglio 2025, per agevolare la transizione ai nuovi report.
Tipi di report
Report di riepilogo pagamenti
Il report di riepilogo pagamenti fornisce una panoramica completa di ogni ordine. Ogni ordine è elencato nella propria riga, semplificando il monitoraggio dei totali e delle commissioni dei singoli ordini. Questo report è ideale per una rapida riconciliazione e per comprendere l'importo netto che riceverai per ogni ordine. Di seguito è riportato un elenco delle colonne nel report:
| Colonna↕ | Descrizione↕ |
|---|---|
| account_name | Il nome del tuo account Zonos |
| payout_date | La data di elaborazione del pagamento |
| arrival_date | La data in cui il pagamento è arrivato sul tuo account |
| payout_number | Identificatore univoco del pagamento |
| payout_total | Importo totale del pagamento |
| currency | Codice valuta del pagamento, ad esempio USD |
| transaction_id | Identificatore univoco della transazione |
| transaction_date | Data in cui è avvenuta la transazione |
| order_number | Identificatore dell'ordine Zonos |
| order_reference | Numero di riferimento dell'ordine della tua piattaforma |
| order_date | Data in cui è stato effettuato l'ordine |
| transaction_type | Tipo di transazione (ORDER, ORDER_REFUND, ORDER_CANCEL) |
| item_order | L'importo totale pagato dagli acquirenti per i prodotti |
| shipping_order | L'importo totale pagato dagli acquirenti per la spedizione |
| discount_order | Eventuali sconti applicati all'ordine |
| duty_tax_fee_order | L'importo totale pagato dagli acquirenti per dazi, imposte e altre commissioni |
| guarantee | L'importo totale riscosso da Zonos per coprire dazi, imposte e commissioni garantiti |
| transaction_fee | Le commissioni totali per l'utilizzo dei servizi Checkout |
| merchant_fee | Le commissioni totali di elaborazione dei pagamenti |
| other | Eventuali addebiti vari con note che forniscono dettagli |
| settled | L'importo finale regolato per l'ordine |
| memo | Informazioni aggiuntive sulla transazione |
Report dettagliato dei pagamenti
Oltre al report di riepilogo, puoi scaricare un report di dettaglio più approfondito per ogni pagamento. Questo report fornisce una ripartizione riga per riga delle transazioni e delle commissioni associate al pagamento. I costi che si compensano, come l'imposta pagata dall'acquirente che Zonos conserva per pagarla per conto del merchant, non sono inclusi nel report. Spesso sono presenti più righe per ordine, poiché ogni tipo di addebito è elencato nella propria riga. Il report dettagliato è utile per riconciliare i documenti finanziari e comprendere le commissioni associate a ogni transazione.
Tipi di addebito nel dettaglio dei pagamenti
Di seguito è riportato un elenco delle possibili voci di riga che potresti vedere in un report dettagliato dei pagamenti e le relative descrizioni:
| Tipo di addebito↕ | Tipo↕ | Descrizione↕ |
|---|---|---|
| ZONOS_MERCHANT_PROCESSING | Commissione di fatturazione Zonos | Commissioni merchant per l'elaborazione dei pagamenti. |
| ZONOS_TRANSACTION | Commissione di fatturazione Zonos | Commissione di transazione Zonos Checkout. |
| CURRENCY_CONVERSION_FEE | Commissione di fatturazione Zonos | Premio forward FX per il rischio di cambio. |
| ZONOS_LANDED_COST | Commissione di fatturazione Zonos | Commissione Zonos Landed Cost Guarantee. |
| ZONOS_LANDED_COST_GUARANTEE | Commissione di fatturazione Zonos | Commissione di garanzia per i calcoli del landed cost. |
| ADVANCEMENT | Commissione del corriere | Addebitata dal corriere di spedizione; consulta la colonna memo del pagamento per maggiori dettagli. |
| BROKERAGE_FEE | Commissione del corriere | Addebitata dal corriere di spedizione; consulta la colonna memo del pagamento per maggiori dettagli. |
| SHIPPING_AMOUNT | Voce del subtotale dell'ordine | Totale della spedizione nell'ordine, utilizzato per garantire che le righe di addebito sommino al totale dell'ordine. |
| PRODUCT_AMOUNT | Voce del subtotale dell'ordine | Totale del carrello nell'ordine, utilizzato per garantire che le righe di addebito sommino al totale dell'ordine. |
| DUTY_TAX_AMOUNT | Voce del subtotale dell'ordine | Totale di dazi/imposte nell'ordine prima delle ritenute, utilizzato per garantire che le righe di addebito sommino al totale dell'ordine. |
| TAX | Voce del subtotale dell'ordine | Totale dell'imposta nell'ordine, utilizzato per garantire che le righe di addebito sommino al totale dell'ordine. Trattenuto per la rimessa fiscale. |
| DUTY | Voce del subtotale dell'ordine | Totale dei dazi nell'ordine, utilizzato per garantire che le righe di addebito sommino al totale dell'ordine. Trattenuto per la rimessa fiscale. |
| GUARANTEE_PERCENT | Commissione di fatturazione Zonos | Commissione di garanzia basata su percentuale per dazi e imposte. |
| GUARANTEE_ORDER | Commissione di fatturazione Zonos | Commissione di garanzia a tariffa fissa per ordine. |
| TRANSACTION_ORDER | Commissione di fatturazione Zonos | Commissione di transazione a tariffa fissa per ordine. |
| TRANSACTION_PERCENT | Commissione di fatturazione Zonos | Commissione di transazione basata su percentuale. |
Tipi di transazione
I report dei pagamenti includono diversi tipi di transazione:
| Tipo di transazione↕ | Descrizione↕ |
|---|---|
| ORDER | Transazioni di ordini regolari in cui sono stati ricevuti fondi. |
| ORDER_REFUND | Transazioni in cui i fondi sono stati restituiti al cliente. |
| ORDER_CANCEL | Transazioni in cui gli ordini sono stati annullati prima dell'elaborazione. |
| Charge | Le transazioni non sono associate a un ordine e costituiscono un addebito. |
| Credit | Le transazioni non sono associate a un ordine e costituiscono un accredito. |
Recuperare i dettagli del pagamento tramite API
Oltre a esportare report CSV da Dashboard, puoi recuperare a livello di codice la stessa ripartizione dettagliata dei pagamenti tramite l'API GraphQL di Zonos. Questa opzione è utile per sincronizzare automaticamente i dati dei pagamenti con i tuoi sistemi di contabilità o riconciliazione.
Ricevere notifiche tramite il webhook ORDER_PAYOUT_DETAILS_READY
Iscriviti al webhook ORDER_PAYOUT_DETAILS_READY per ricevere una notifica quando i dettagli delle voci di riga di un pagamento sono disponibili per la query. Riceverlo significa che la ripartizione del pagamento è finale e sicura da recuperare. Il webhook fornisce il valore payoutId da utilizzare per recuperare i dettagli; non incorpora i dettagli stessi. Consulta la guida ai webhook per scoprire come configurare i webhook.
{ "payoutId": "payout_xxxxxxxxxxxxx", "eventType": "ORDER_PAYOUT_DETAILS_READY"}Eseguire una query dei dettagli del pagamento
Passa payoutId alla query
orderPayoutDetails. Restituisce una connessione paginata di voci di riga
OrderPayoutDetailItem, una riga per transazione, che rispecchia il report CSV Dettaglio pagamenti trattato in Esportare report CSV sopra.
query OrderPayoutDetails($payoutId: String!, $first: Int, $after: String) { orderPayoutDetails(payoutId: $payoutId, first: $first, after: $after) { totalAmount edges { cursor node { accountName payoutDate arrivalDate payoutNumber currency transactionId transactionDate orderNumber orderReference orderDate transactionType detailType payee payor amount memo } } pageInfo { hasNextPage endCursor } }}La connessione espone anche un campo totalAmount, ovvero la somma di amount nelle voci di riga visibili alla tua organizzazione, così puoi ottenere il totale del pagamento senza sommare personalmente ogni pagina.
Visualizzare i pagamenti
Scopri come accedere e comprendere i dettagli dei tuoi pagamenti per Checkout.
Accedi facilmente ai report dei pagamenti e visualizzali in Zonos Dashboard. I pagamenti vengono generati regolarmente e forniscono una ripartizione dettagliata di transazioni, commissioni e importi netti quando utilizzi Zonos Checkout. I pagamenti vengono emessi nella valuta locale selezionata durante la configurazione dell'account. Questi report ti aiutano a riconciliare i documenti finanziari e monitorare i tuoi guadagni.