Learn how to access and understand your payout details for Checkout.
Easily access and view your payout reports in the Zonos Dashboard. Payouts are generated regularly, providing a detailed breakdown of transactions, fees, and net amounts when using Zonos Checkout. Payouts are issued in your local currency that was selected when you set up your account. These reports help you reconcile financial records and track your earnings.
For additional reports, such as order details and a breakdown of landed cost calculations, visit Reports. Learn how to use them in Downloadable reports.
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.
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.
Transaction fee: 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.
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.
Transaction fee: 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.
Zonos fees breakdown per 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).
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.
Report types
Payout summary report
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
Payout detail report
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.
Payout detail charge types
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.
Transaction Types
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.
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.
Get notified with the ORDER_PAYOUT_DETAILS_READY webhook
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.
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.
Paginate large payouts
A single payout can contain many transactions. Use the first and after
arguments to page through results, following pageInfo.endCursor until
pageInfo.hasNextPage is false.
Payouts
View payouts
Learn how to access and understand your payout details for Checkout.
Easily access and view your payout reports in the Zonos Dashboard. Payouts are generated regularly, providing a detailed breakdown of transactions, fees, and net amounts when using Zonos Checkout. Payouts are issued in your local currency that was selected when you set up your account. These reports help you reconcile financial records and track your earnings.
Access payout data
To find and view a payout in Dashboard:
Multiple payouts
To view information across multiple payouts:
Payout overview
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:
For each component, the following details are shown:
For more detail, export the CSV report.
Transactions within a payout
Each transaction within the payout is listed in the Transactions section. At a glance, the following details are available per transaction:
Zonos fees breakdown per 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).
Export CSV reports
You can export two types of reports—Payout summary and Payout detail. Compare them on the Downloadable reports page.
Export a single payout
To export a CSV of a specific payout:
Multiple payout periods
To export a CSV that crosses multiple payout periods:
Report types
Payout summary report
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:
Payout detail report
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.
Payout detail charge types
Below is a list of possible line items you may see on a payout detail report and their descriptions:
memocolumn for more detail.memocolumn for more detail.Transaction Types
The payout reports include different types of transactions:
Retrieve payout details 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.
Get notified with the ORDER_PAYOUT_DETAILS_READY webhook
Subscribe to the
ORDER_PAYOUT_DETAILS_READYwebhook 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 thepayoutIdyou 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"}Query payout details
Pass the
payoutIdto theorderPayoutDetailsquery. It returns a paginated connection ofOrderPayoutDetailItemline 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) {totalAmountedges {cursornode {accountNamepayoutDatearrivalDatepayoutNumbercurrencytransactionIdtransactionDateorderNumberorderReferenceorderDatetransactionTypedetailTypepayeepayoramountmemo}}pageInfo {hasNextPageendCursor}}}The connection also exposes a
totalAmountfield—the sum ofamountacross the line items visible to your organization—so you can get the payout total without summing every page yourself.A single payout can contain many transactions. Use the
firstandafterarguments to page through results, followingpageInfo.endCursoruntilpageInfo.hasNextPageisfalse.Was this page helpful?