Accéder aux données de paiement
Pour trouver et consulter un paiement dans Dashboard :
- Go to Dashboard -> Payouts.
- Select the payout you want to view. If it doesn't appear immediately, filter by date or amount to narrow your search. (The date is the payout arrival date).
- View the payout overview and the list of transactions within Dashboard.
- For more details, click Export transactions to download an CSV file of either the Payout summary or Payout details.
- Legacy export: The legacy report format is still available on the individual payout page until July 31st, 2025, to help with the transition to our new reports.
Paiements multiples
To view information across multiple payouts:
- Go to Dashboard -> Payouts.
- Click Export in the top right.
- Select your preferred type of report: Payout summary or Payout details.
- Adjust the date ranges. Date ranges are based on the order transaction date (not the payout arrival date).
- Click Generate report.
Aperçu du paiement
The payout page provides a high-level view of your payout so you can quickly understand key details without needing to export a report.
Each payout is broken into four components, then totaled:
- Payments: Transactions where funds were received.
- Refunds: Transactions where funds were returned.
- Charges: Fees deducted from the payout, such as transaction fees or adjustments.
- Credits: Reimbursements applied to your payout, such as refunds for overcharged fees or other credits issued to your account.
- Failed previous payout: If a previous payout failed, and was later sent with a subsequent payout, this line will include those details.
For each component, the following details are shown:
- Items: The total amount shoppers paid for products within the payout period.
- Shipping: The total amount shoppers paid for shipping within the payout period.
- Discount: The total discounts applied to orders within the payout period.
- Duty, taxes, fees: The total amount shoppers paid for duties, taxes, and other fees within the payout period.
- Guarantee: The total amount Zonos collected to cover guaranteed duties, taxes, and fees, which Zonos paid on your behalf. These costs are guaranteed by Zonos.
- Frais de transaction: The total fees for using Checkout services, including fraud protection (excludes payment processing fees).
- Merchant fee: The total payment processing fees deducted from the payout.
- Other: The total of any miscellaneous charges within the payout period, with memos providing details.
- Total: The net total for the payout.
For more detail, export the CSV report.

Transactions dans un paiement
Each transaction within the payout is listed in the Transactions section. At a glance, the following details are available per transaction:
- Date: The date of the transaction.
- Order number: The zonos order number associated with the transaction.
- Items: The amount the shopper paid for products.
- Shipping: The amount the shopper paid for shipping.
- Discount: Any discounts applied to the order.
- Duty, taxes, fees: The amount the shopper paid for duties, taxes, and other fees.
- Guarantee: The amount Zonos collects to cover guaranteed duties, taxes, and fees, which Zonos pays on your behalf. These costs are guaranteed by Zonos.
- Frais de transaction: The fee for using Checkout services, including fraud protection (excludes payment processing fees).
- Merchant fee: The fee for payment processing.
- Other: Miscellaneous charges with a memo explaining the reason.
- Total: The net total for the transaction included in the payout.
Ventilation des frais Zonos par transaction
Click on the order number of a transaction to view a detailed breakdown, including product amounts, shipping costs, duties, taxes, and itemized fees (passthrough costs will not display). If no fees appear, they may not apply to that transaction (e.g., refunds or DDU orders).
Exporter des rapports CSV
You can export two types of reports—Payout summary and Payout detail. Compare them on the Downloadable reports page.
Exporter un paiement unique
To export a CSV of a specific payout:
- Go to Dashboard -> Payouts
- Click into a specific payout
- Click Export transactions on any payout page
- Choose between Payout summary or Payout detail
- This exports data for just that specific payout
Périodes de paiement multiples
To export a CSV that crosses multiple payout periods:
- Go to Dashboard -> Payouts
- Click Export in the top right
- Select Payout summary or Payout detail
- Choose your date range (based on order transaction date)
- Click Generate report
Note: The legacy report format is still available on individual payout pages until July 31st, 2025, to help with the transition to our new reports.
Types de rapports
Rapport récapitulatif de paiement
The Payout summary report provides a comprehensive view of each order. Each order is listed on its own row, making it easy to track individual order totals and fees. This report is ideal for quick reconciliation and understanding the net amount you'll receive for each order. Below is a list of the columns in the report:
| Column↕ | Description↕ |
|---|---|
| account_name | The name of your Zonos account |
| payout_date | The date the payout was processed |
| arrival_date | The date the payout arrived in your account |
| payout_number | Unique identifier for the payout |
| payout_total | Total amount of the payout |
| currency | Currency code for the payout (e.g., USD) |
| transaction_id | Unique identifier for the transaction |
| transaction_date | Date the transaction occurred |
| order_number | Zonos order identifier |
| order_reference | Your platform's order reference number |
| order_date | Date the order was placed |
| transaction_type | Type of transaction (ORDER, ORDER_REFUND, ORDER_CANCEL) |
| item_order | The total amount shoppers paid for products |
| shipping_order | The total amount shoppers paid for shipping |
| discount_order | Any discounts applied to the order |
| duty_tax_fee_order | The total amount shoppers paid for duties, taxes, and other fees |
| guarantee | The total amount Zonos collected to cover guaranteed duties, taxes, and fees |
| transaction_fee | The total fees for using Checkout services |
| merchant_fee | The total payment processing fees |
| other | Any miscellaneous charges with memos providing details |
| settled | The final amount settled for the order |
| memo | Additional information about the transaction |
Rapport détaillé de paiement
In addition to the summary report, you can download a more in-depth details report for each payout. This report provides a line-by-line breakdown of the transactions and fees associated with the payout. Costs that net (such as tax a shopper pays, that Zonos keeps to pay on the merchant's behalf) are not included in this report. There will often be multiple rows per order, as each charge type is listed on its own line. The details report is useful for reconciling your financial records and understanding the fees associated with each transaction.
Types de charges du rapport détaillé
Below is a list of possible line items you may see on a payout detail report and their descriptions:
| Charge type↕ | Type↕ | Description↕ |
|---|---|---|
| ZONOS_MERCHANT_PROCESSING | Zonos billing fee | Merchant fees for payment processing. |
| ZONOS_TRANSACTION | Zonos billing fee | Zonos Checkout transaction fee. |
| CURRENCY_CONVERSION_FEE | Zonos billing fee | FX forward premium for foreign exchange risk. |
| ZONOS_LANDED_COST | Zonos billing fee | Zonos Landed Cost Guarantee fee. |
| ZONOS_LANDED_COST_GUARANTEE | Zonos billing fee | Guarantee fee for landed cost calculations. |
| ADVANCEMENT | Carrier fee | Charged by shipping carrier-see Payout memo column for more detail. |
| BROKERAGE_FEE | Carrier fee | Charged by shipping carrier-see Payout memo column for more detail. |
| SHIPPING_AMOUNT | Order subtotal item | Shipping total on the order, used to ensure charge lines add up to order total. |
| PRODUCT_AMOUNT | Order subtotal item | Cart total on the order, used to ensure charge lines add up to order total. |
| DUTY_TAX_AMOUNT | Order subtotal item | Duty/tax total on the order before withholdings, used to ensure charge lines add up to order total. |
| TAX | Order subtotal item | Tax total on the order, used to ensure charge lines add up to order total. Withheld for tax remittance. |
| DUTY | Order subtotal item | Duty total on the order, used to ensure charge lines add up to order total. Withheld for tax remittance. |
| GUARANTEE_PERCENT | Zonos billing fee | Percentage-based guarantee fee for duties and taxes. |
| GUARANTEE_ORDER | Zonos billing fee | Flat-rate guarantee fee per order. |
| TRANSACTION_ORDER | Zonos billing fee | Flat-rate transaction fee per order. |
| TRANSACTION_PERCENT | Zonos billing fee | Percentage-based transaction fee. |
Types de transaction
The payout reports include different types of transactions:
| Transaction Type↕ | Description↕ |
|---|---|
| ORDER | Regular order transactions where funds were received. |
| ORDER_REFUND | Transactions where funds were returned to the customer. |
| ORDER_CANCEL | Transactions where orders were cancelled before processing. |
| Charge | Transactions are not associated with an order and are a charge. |
| Credit | Transactions are not associated with an order and are a credit. |
Récupérer les détails de paiement via API
In addition to exporting CSV reports from Dashboard, you can retrieve the same payout detail breakdown programmatically through the Zonos GraphQL API. This is useful for automatically syncing payout data into your own accounting or reconciliation systems.
Être notifié avec le webhook ORDER_PAYOUT_DETAILS_READY
Subscribe to the ORDER_PAYOUT_DETAILS_READY webhook to be notified when a
payout's line-item details are available to query. Receiving it means the
payout breakdown is final and safe to pull. The webhook delivers the payoutId
you use to fetch the details—it does not embed the details themselves. See the
webhooks guide to learn how to set up webhooks.
{ "payoutId": "payout_xxxxxxxxxxxxx", "eventType": "ORDER_PAYOUT_DETAILS_READY"}Interroger les détails de paiement
Pass the payoutId to the
orderPayoutDetails query. It returns
a paginated connection of
OrderPayoutDetailItem line
items—one row per transaction—mirroring the Payout detail CSV report
covered in
Export CSV reports
above.
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 } }}The connection also exposes a totalAmount field—the sum of amount across
the line items visible to your organization—so you can get the payout total
without summing every page yourself.
Consulter les paiements
Découvrez comment accéder à vos paiements et comprendre leurs détails pour Checkout.
Accédez facilement à vos rapports de paiement et consultez-les dans le Dashboard Zonos. Les paiements sont générés régulièrement et fournissent une ventilation détaillée des transactions, frais et montants nets lors de l'utilisation de Zonos Checkout. Payouts are issued in your local currency that was selected when you set up your account. Ces rapports vous aident à rapprocher vos registres financiers et à suivre vos revenus.