DOCS

查看支付

了解如何访问和理解您的 Checkout 支付详情。

在 Zonos Dashboard 中轻松访问和查看您的支付报告。使用 Zonos Checkout 时,支付会定期生成,提供交易、费用和净额的详细明细。支付以您设置帐户时选择的当地货币发放。这些报告可帮助您协调财务记录并跟踪您的收入。

有关其他报告(例如订单详情和 landed cost 计算明细),请访问 Reports。了解如何在 Downloadable reports 中使用它们。

访问支付数据 

要在 Dashboard 中查找和查看支付:

  1. 转到 Dashboard -> Payouts
  2. 选择您要查看的支付。如果它没有立即显示,请按日期或金额筛选以缩小搜索范围。(日期 是支付到达日期)。
  3. 在 Dashboard 中查看支付概览和交易列表。
  4. 有关更多详情,请单击 Export transactions 以下载 Payout summaryPayout details 的 CSV 文件。
    1. Legacy export: 旧版报告格式仍可在各个支付页面上获得,直到 2025 年 7 月 31 日,以帮助过渡到我们的新报告。

多个支付

要跨多个支付查看信息:

  1. 转到 Dashboard -> Payouts
  2. 单击右上角的 Export
  3. 选择您首选的报告类型:Payout summaryPayout details
  4. 调整日期范围。日期范围基于订单交易日期(不是支付到达日期)。
  5. 单击 Generate report

支付概览 

支付页面提供支付的高级视图,这样您可以快速了解关键详情,而无需导出报告。

每个支付分为四个部分,然后汇总:

  • Payments:收到资金的交易。
  • Refunds:返还资金的交易。
  • Charges:从支付中扣除的费用,例如交易费或调整。
  • Credits:应用于您的支付的退款,例如多收费用的退款或发放给您帐户的其他信用。
  • Failed previous payout:如果之前的支付失败,并在后续支付中发送,此行将包括这些详情。

对于每个部分,显示以下详情:

  • Items:购物者在支付期间为产品支付的总金额。
  • Shipping:购物者在支付期间为运输支付的总金额。
  • Discount:在支付期间应用于订单的总折扣。
  • Duty, taxes, fees:购物者在支付期间为关税、税款和其他费用支付的总金额。
  • Guarantee:Zonos 收集的用于覆盖有保证的关税、税款和费用的总金额,由 Zonos 代表您支付。这些费用由 Zonos 保证。
  • Transaction fee:使用 Checkout 服务的总费用,包括欺诈保护(不包括支付处理费)。
  • Merchant fee:从支付中扣除的总支付处理费。
  • Other:支付期间任何杂项费用的总额,备忘录提供详情。
  • Total:支付的净总额。

有关更多详情,请导出 CSV report

Payout example

支付内的交易

支付内的每笔交易在 Transactions 部分列出。一目了然,每笔交易可获得以下详情:

  • Date:交易的日期。
  • Order number:与交易关联的 zonos 订单号。
  • Items:购物者为产品支付的金额。
  • Shipping:购物者为运输支付的金额。
  • Discount:应用于订单的任何折扣。
  • Duty, taxes, fees:购物者为关税、税款和其他费用支付的金额。
  • Guarantee:Zonos 收集的用于覆盖有保证的关税、税款和费用的金额,由 Zonos 代表您支付。这些费用由 Zonos 保证。
  • Transaction fee:使用 Checkout 服务的费用,包括欺诈保护(不包括支付处理费)。
  • Merchant fee:支付处理费。
  • Other:带有说明原因备忘录的杂项费用。
  • Total:交易的净总额(包括在支付中)。

每笔交易的 Zonos 费用明细

单击交易的订单号以查看详细明细,包括产品金额、运输成本、关税、税款和项目化费用(传递费用将不显示)。如果没有显示任何费用,它们可能不适用于该交易(例如,退款或 DDU 订单)。

导出 CSV 报告 

您可以导出两种类型的报告——Payout summaryPayout detail。在 Downloadable reports 页面上比较它们。

导出单个支付

要导出特定支付的 CSV:

  1. 转到 Dashboard -> Payouts
  2. 单击特定支付
  3. 在任何支付页面上单击 Export transactions
  4. 选择 Payout summaryPayout detail
  5. 这仅导出该特定支付的数据

多个支付期间

要导出跨越多个支付期间的 CSV:

  1. 转到 Dashboard -> Payouts
  2. 单击右上角的 Export
  3. 选择 Payout summaryPayout detail
  4. 选择您的日期范围(基于订单交易日期)
  5. 单击 Generate report

Note: 旧版报告格式仍可在各个支付页面上获得,直到 2025 年 7 月 31 日,以帮助过渡到我们的新报告。

报告类型

Payout summary 报告

Payout summary 报告提供每个订单的综合视图。每个订单在其自己的行上列出,使跟踪各个订单总额和费用变得容易。此报告适合快速对账和了解您将为每个订单收到的净额。以下是报告中列的列表:

ColumnDescription
account_name您的 Zonos 帐户的名称
payout_date处理支付的日期
arrival_date支付到达您帐户的日期
payout_number支付的唯一标识符
payout_total支付的总金额
currency支付的货币代码(例如,USD)
transaction_id交易的唯一标识符
transaction_date交易发生的日期
order_numberZonos 订单标识符
order_reference您的平台的订单参考号
order_date订单的下单日期
transaction_type交易类型(ORDER、ORDER_REFUND、ORDER_CANCEL)
item_order购物者为产品支付的总金额
shipping_order购物者为运输支付的总金额
discount_order应用于订单的任何折扣
duty_tax_fee_order购物者为关税、税款和其他费用支付的总金额
guaranteeZonos 收集的用于覆盖有保证的关税、税款和费用的总金额
transaction_fee使用 Checkout 服务的总费用
merchant_fee总支付处理费
other带有提供详情备忘录的任何杂项费用
settled为订单结算的最终金额
memo有关交易的其他信息

Payout detail 报告

除了汇总报告外,您还可以为每个支付下载更深入的 details 报告。此报告提供与支付相关的交易和费用的逐行明细。相互抵消的成本(例如购物者支付的税款,由 Zonos 保留以代表商家支付)不包括在此报告中。通常每个订单有多行,因为每种费用类型在其自己的行上列出。详情报告对于协调您的财务记录和了解与每笔交易相关的费用很有用。

Payout detail 费用类型

以下是您在支付详情报告上可能看到的可能行项目及其说明的列表:

Charge typeTypeDescription
ZONOS_MERCHANT_PROCESSINGZonos billing fee支付处理的商家费用。
ZONOS_TRANSACTIONZonos billing feeZonos Checkout 交易费。
CURRENCY_CONVERSION_FEEZonos billing fee外汇远期溢价以应对外汇风险。
ZONOS_LANDED_COSTZonos billing feeZonos Landed Cost 保证费。
ZONOS_LANDED_COST_GUARANTEEZonos billing feelanded cost 计算的保证费。
ADVANCEMENTCarrier fee由运输承运人收费-有关更多详情,请参阅支付 memo 列。
BROKERAGE_FEECarrier fee由运输承运人收费-有关更多详情,请参阅支付 memo 列。
SHIPPING_AMOUNTOrder subtotal item订单上的运输总额,用于确保费用行加起来等于订单总额。
PRODUCT_AMOUNTOrder subtotal item订单上的购物车总额,用于确保费用行加起来等于订单总额。
DUTY_TAX_AMOUNTOrder subtotal item订单上在扣缴之前的关税/税款总额,用于确保费用行加起来等于订单总额。
TAXOrder subtotal item订单上的税款总额,用于确保费用行加起来等于订单总额。为税款缴款扣留。
DUTYOrder subtotal item订单上的关税总额,用于确保费用行加起来等于订单总额。为税款缴款扣留。
GUARANTEE_PERCENTZonos billing fee关税和税款的基于百分比的保证费。
GUARANTEE_ORDERZonos billing fee每个订单的固定费率保证费。
TRANSACTION_ORDERZonos billing fee每个订单的固定费率交易费。
TRANSACTION_PERCENTZonos billing fee基于百分比的交易费。

交易类型

支付报告包括不同类型的交易:

Transaction TypeDescription
ORDER收到资金的常规订单交易。
ORDER_REFUND向客户返还资金的交易。
ORDER_CANCEL在处理前取消的订单的交易。
Charge与订单无关的交易,是一项费用。
Credit与订单无关的交易,是一项信用。

通过 API 检索支付详情 

除了从 Dashboard 导出 CSV 报告外,您还可以通过 Zonos GraphQL API 以编程方式检索相同的 支付详情明细。这对于自动将支付数据同步到您自己的会计或 对账系统很有用。

使用 ORDER_PAYOUT_DETAILS_READY webhook 获取通知

订阅 ORDER_PAYOUT_DETAILS_READY webhook 以在支付的行项目详情可供查询时获得通知。接收它意味着 支付明细是最终的并且可以安全拉取。webhook 提供您用于获取详情的 payoutId——它不嵌入详情本身。请参阅 webhooks guide 以了解如何设置 webhook。

1{
2 "payoutId": "payout_xxxxxxxxxxxxx",
3 "eventType": "ORDER_PAYOUT_DETAILS_READY"
4}

查询支付详情

payoutId 传递给 orderPayoutDetails 查询。它返回 OrderPayoutDetailItem 行项目的分页连接——每行一笔交易——与上方 Export CSV reports 中介绍的 Payout detail CSV 报告相对应。

1query OrderPayoutDetails($payoutId: String!, $first: Int, $after: String) {
2 orderPayoutDetails(payoutId: $payoutId, first: $first, after: $after) {
3 totalAmount
4 edges {
5 cursor
6 node {
7 accountName
8 payoutDate
9 arrivalDate
10 payoutNumber
11 currency
12 transactionId
13 transactionDate
14 orderNumber
15 orderReference
16 orderDate
17 transactionType
18 detailType
19 payee
20 payor
21 amount
22 memo
23 }
24 }
25 pageInfo {
26 hasNextPage
27 endCursor
28 }
29 }
30}

该连接还公开了 totalAmount 字段——即您的组织可见的所有行项目中 amount 的总和——因此您无需自行对每一页求和即可获得支付总额。

分页大支付

单个支付可能包含许多交易。使用 firstafter 参数分页浏览结果,跟踪 pageInfo.endCursor 直到 pageInfo.hasNextPagefalse

预约演示

这个页面有帮助吗?


获取支持·法律文件·© 2026 Zonos