查看付款

瞭解如何存取及理解您的 Checkout 付款詳細資訊。

在 Zonos Dashboard 中輕鬆存取及查看您的付款報告。在使用 Zonos Checkout 時,付款會定期產生,提供交易、手續費和淨額的詳細明細。付款以您在設定帳戶時選擇的當地貨幣發出。這些報告可協助您對帳財務紀錄並追蹤您的收益。

如需其他報告(例如訂單詳細資訊和落地成本計算的明細),請造訪 報告。瞭解如何在 可下載的報告 中使用它們。

存取付款資料 

若要在 Dashboard 中尋找並查看付款:

  1. 前往 Dashboard -> Payouts
  2. 選擇您要查看的付款。如果它未立即顯示,請按日期或金額篩選以縮小搜尋範圍。(日期是付款到達日期)。
  3. 在 Dashboard 中查看付款概況和交易清單。
  4. 如需更多詳細資訊,請按一下 Export transactions 以下載 Payout summaryPayout details 的 CSV 檔案。
    1. 舊版匯出:舊版報告格式仍可在個別付款頁面上取得,至 2025 年 7 月 31 日為止,以協助轉換至我們的新報告。

多筆付款

若要查看多筆付款的資訊:

  1. 前往 Dashboard -> Payouts
  2. 按一下右上角的 Export
  3. 選擇您偏好的報告類型:Payout summaryPayout details
  4. 調整日期範圍。日期範圍是根據訂單交易日期(不是付款到達日期)。
  5. 按一下 Generate report

付款概況 

付款頁面提供您付款的高階檢視,讓您無需匯出報告即可快速瞭解關鍵詳細資訊。

每筆付款分為四個部分,然後合計:

  • 付款:收到資金的交易。
  • 退款:退回資金的交易。
  • 費用:從付款中扣除的手續費,例如交易手續費或調整。
  • 貸項:套用至您付款的補償,例如高額手續費的退款或簽發至您帳戶的其他貸項。
  • 失敗的上一筆付款:如果上一筆付款失敗,並隨後與後續付款一起寄出,此行將包含這些詳細資訊。

對於每個部分,會顯示下列詳細資訊:

  • 項目:購物者在付款期間為產品支付的總金額。
  • 運費:購物者在付款期間為運費支付的總金額。
  • 折扣:在付款期間套用至訂單的折扣總額。
  • 關稅、稅金、手續費:購物者在付款期間為關稅、稅金和其他手續費支付的總金額。
  • 保證:Zonos 收集的金額以涵蓋保證的關稅、稅金和手續費,Zonos 代表您支付。這些費用由 Zonos 保證。
  • 交易手續費:使用 Checkout 服務的總手續費,包括詐騙防護(不包括付款處理手續費)。
  • 商家手續費:從付款中扣除的總付款處理手續費。
  • 其他:付款期間任何雜項費用的總額,備忘錄提供詳細資訊。
  • 總計:付款的淨總額。

如需詳細資訊,請匯出 CSV 報告

Payout example

付款中的交易

每筆付款中的每筆交易都列在 Transactions 部分中。概略一覽,每筆交易都提供下列詳細資訊:

  • 日期:交易的日期。
  • 訂單號碼:與交易相關聯的 zonos 訂單號碼。
  • 項目:購物者為產品支付的金額。
  • 運費:購物者為運費支付的金額。
  • 折扣:套用至訂單的任何折扣。
  • 關稅、稅金、手續費:購物者為關稅、稅金和其他手續費支付的金額。
  • 保證:Zonos 收集的金額以涵蓋保證的關稅、稅金和手續費,Zonos 代表您支付。這些費用由 Zonos 保證。
  • 交易手續費:使用 Checkout 服務的手續費,包括詐騙防護(不包括付款處理手續費)。
  • 商家手續費:付款處理的手續費。
  • 其他:具有說明原因的備忘錄的雜項費用。
  • 總計:付款中包含的交易淨總額。

每筆交易的 Zonos 手續費明細

按一下交易的訂單號碼以查看詳細明細,包括產品金額、運費、關稅、稅金和逐項手續費(傳遞費用不會顯示)。如果未顯示任何手續費,可能不適用於該交易(例如,退款或 DDU 訂單)。

匯出 CSV 報告 

您可以匯出兩種類型的報告—Payout summaryPayout detail。在 可下載的報告 頁面上比較它們。

匯出單筆付款

若要匯出特定付款的 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

注意:舊版報告格式仍可在個別付款頁面上取得,至 2025 年 7 月 31 日為止,以協助轉換至我們的新報告。

報告類型

Payout summary 報告

Payout summary 報告提供每筆訂單的綜合檢視。每筆訂單都列在其本身的列上,可輕鬆追蹤個別訂單總額和手續費。此報告適合快速對帳和瞭解您將為每筆訂單收到的淨金額。以下是報告中的欄位清單:

欄位說明
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 報告

除了摘要報告外,您還可以為每筆付款下載更深入的 詳細資訊報告。此報告提供與付款相關聯的交易和手續費的逐行明細。淨化的費用(例如購物者支付的稅金,Zonos 保留以代表商家支付)不包括在此報告中。通常每筆訂單會有多列,因為每種費用類型都列在其本身的行上。詳細資訊報告適合對帳您的財務紀錄和瞭解與每筆交易相關聯的手續費。

Payout detail 費用類型

以下是您在 payout detail 報告上可能看到的可能的逐行項目及其說明清單:

費用類型類型說明
ZONOS_MERCHANT_PROCESSINGZonos 計費費用付款處理的商家手續費。
ZONOS_TRANSACTIONZonos 計費費用Zonos Checkout 交易手續費。
CURRENCY_CONVERSION_FEEZonos 計費費用外匯前沿溢價以降低外匯風險。
ZONOS_LANDED_COSTZonos 計費費用Zonos 落地成本保證手續費。
ZONOS_LANDED_COST_GUARANTEEZonos 計費費用落地成本計算的保證手續費。
ADVANCEMENT運輸公司手續費由運輸公司收取 - 詳細資訊請參閱 Payout memo 欄位。
BROKERAGE_FEE運輸公司手續費由運輸公司收取 - 詳細資訊請參閱 Payout memo 欄位。
SHIPPING_AMOUNT訂單小計項目訂單的運費總額,用於確保費用行加總到訂單總額。
PRODUCT_AMOUNT訂單小計項目訂單的購物車總額,用於確保費用行加總到訂單總額。
DUTY_TAX_AMOUNT訂單小計項目預扣前訂單的關稅/稅金總額,用於確保費用行加總到訂單總額。
TAX訂單小計項目訂單的稅金總額,用於確保費用行加總到訂單總額。為稅務匯款預扣。
DUTY訂單小計項目訂單的關稅總額,用於確保費用行加總到訂單總額。為稅務匯款預扣。
GUARANTEE_PERCENTZonos 計費費用關稅和稅金的基於百分比的保證手續費。
GUARANTEE_ORDERZonos 計費費用每筆訂單的定額保證手續費。
TRANSACTION_ORDERZonos 計費費用每筆訂單的定額交易手續費。
TRANSACTION_PERCENTZonos 計費費用基於百分比的交易手續費。

交易類型

付款報告包括不同類型的交易:

交易類型說明
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 指南 以瞭解如何設定 webhooks。

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

查詢付款詳細資訊

payoutId 傳遞至 orderPayoutDetails 查詢。它會傳回 OrderPayoutDetailItem 逐行項目的分頁連結—每筆交易一列—鏡像 Payout detail CSV 報告,涵蓋於上面的 匯出 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