存取付款資料
若要在 Dashboard 中尋找並查看付款:
- 前往 Dashboard -> Payouts。
- 選擇您要查看的付款。如果它未立即顯示,請按日期或金額篩選以縮小搜尋範圍。(日期是付款到達日期)。
- 在 Dashboard 中查看付款概況和交易清單。
- 如需更多詳細資訊,請按一下 Export transactions 以下載 Payout summary 或 Payout details 的 CSV 檔案。
- 舊版匯出:舊版報告格式仍可在個別付款頁面上取得,至 2025 年 7 月 31 日為止,以協助轉換至我們的新報告。
多筆付款
若要查看多筆付款的資訊:
- 前往 Dashboard -> Payouts。
- 按一下右上角的 Export。
- 選擇您偏好的報告類型:Payout summary 或 Payout details。
- 調整日期範圍。日期範圍是根據訂單交易日期(不是付款到達日期)。
- 按一下 Generate report。
付款概況
付款頁面提供您付款的高階檢視,讓您無需匯出報告即可快速瞭解關鍵詳細資訊。
每筆付款分為四個部分,然後合計:
- 付款:收到資金的交易。
- 退款:退回資金的交易。
- 費用:從付款中扣除的手續費,例如交易手續費或調整。
- 貸項:套用至您付款的補償,例如高額手續費的退款或簽發至您帳戶的其他貸項。
- 失敗的上一筆付款:如果上一筆付款失敗,並隨後與後續付款一起寄出,此行將包含這些詳細資訊。
對於每個部分,會顯示下列詳細資訊:
- 項目:購物者在付款期間為產品支付的總金額。
- 運費:購物者在付款期間為運費支付的總金額。
- 折扣:在付款期間套用至訂單的折扣總額。
- 關稅、稅金、手續費:購物者在付款期間為關稅、稅金和其他手續費支付的總金額。
- 保證:Zonos 收集的金額以涵蓋保證的關稅、稅金和手續費,Zonos 代表您支付。這些費用由 Zonos 保證。
- 交易手續費:使用 Checkout 服務的總手續費,包括詐騙防護(不包括付款處理手續費)。
- 商家手續費:從付款中扣除的總付款處理手續費。
- 其他:付款期間任何雜項費用的總額,備忘錄提供詳細資訊。
- 總計:付款的淨總額。
如需詳細資訊,請匯出 CSV 報告。

付款中的交易
每筆付款中的每筆交易都列在 Transactions 部分中。概略一覽,每筆交易都提供下列詳細資訊:
- 日期:交易的日期。
- 訂單號碼:與交易相關聯的 zonos 訂單號碼。
- 項目:購物者為產品支付的金額。
- 運費:購物者為運費支付的金額。
- 折扣:套用至訂單的任何折扣。
- 關稅、稅金、手續費:購物者為關稅、稅金和其他手續費支付的金額。
- 保證:Zonos 收集的金額以涵蓋保證的關稅、稅金和手續費,Zonos 代表您支付。這些費用由 Zonos 保證。
- 交易手續費:使用 Checkout 服務的手續費,包括詐騙防護(不包括付款處理手續費)。
- 商家手續費:付款處理的手續費。
- 其他:具有說明原因的備忘錄的雜項費用。
- 總計:付款中包含的交易淨總額。
每筆交易的 Zonos 手續費明細
按一下交易的訂單號碼以查看詳細明細,包括產品金額、運費、關稅、稅金和逐項手續費(傳遞費用不會顯示)。如果未顯示任何手續費,可能不適用於該交易(例如,退款或 DDU 訂單)。
匯出 CSV 報告
您可以匯出兩種類型的報告—Payout summary 和 Payout detail。在 可下載的報告 頁面上比較它們。
匯出單筆付款
若要匯出特定付款的 CSV:
- 前往 Dashboard -> Payouts
- 按一下特定付款
- 在任何付款頁面上按一下 Export transactions
- 選擇 Payout summary 或 Payout detail
- 這僅會匯出該特定付款的資料
多個付款期間
若要匯出跨越多個付款期間的 CSV:
- 前往 Dashboard -> Payouts
- 按一下右上角的 Export
- 選擇 Payout summary 或 Payout detail
- 選擇您的日期範圍(根據訂單交易日期)
- 按一下 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_number | Zonos 訂單識別碼 |
| order_reference | 您的平台訂單參考號碼 |
| order_date | 訂單下單的日期 |
| transaction_type | 交易類型(ORDER、ORDER_REFUND、ORDER_CANCEL) |
| item_order | 購物者為產品支付的總金額 |
| shipping_order | 購物者為運費支付的總金額 |
| discount_order | 套用至訂單的任何折扣 |
| duty_tax_fee_order | 購物者為關稅、稅金和其他手續費支付的總金額 |
| guarantee | Zonos 收集以涵蓋保證的關稅、稅金和手續費的總金額 |
| transaction_fee | 使用 Checkout 服務的總手續費 |
| merchant_fee | 總付款處理手續費 |
| other | 任何雜項費用的總額,備忘錄提供詳細資訊 |
| settled | 訂單結清的最終金額 |
| memo | 交易的其他資訊 |
Payout detail 報告
除了摘要報告外,您還可以為每筆付款下載更深入的 詳細資訊報告。此報告提供與付款相關聯的交易和手續費的逐行明細。淨化的費用(例如購物者支付的稅金,Zonos 保留以代表商家支付)不包括在此報告中。通常每筆訂單會有多列,因為每種費用類型都列在其本身的行上。詳細資訊報告適合對帳您的財務紀錄和瞭解與每筆交易相關聯的手續費。
Payout detail 費用類型
以下是您在 payout detail 報告上可能看到的可能的逐行項目及其說明清單:
| 費用類型↕ | 類型↕ | 說明↕ |
|---|---|---|
| ZONOS_MERCHANT_PROCESSING | Zonos 計費費用 | 付款處理的商家手續費。 |
| ZONOS_TRANSACTION | Zonos 計費費用 | Zonos Checkout 交易手續費。 |
| CURRENCY_CONVERSION_FEE | Zonos 計費費用 | 外匯前沿溢價以降低外匯風險。 |
| ZONOS_LANDED_COST | Zonos 計費費用 | Zonos 落地成本保證手續費。 |
| ZONOS_LANDED_COST_GUARANTEE | Zonos 計費費用 | 落地成本計算的保證手續費。 |
| ADVANCEMENT | 運輸公司手續費 | 由運輸公司收取 - 詳細資訊請參閱 Payout memo 欄位。 |
| BROKERAGE_FEE | 運輸公司手續費 | 由運輸公司收取 - 詳細資訊請參閱 Payout memo 欄位。 |
| SHIPPING_AMOUNT | 訂單小計項目 | 訂單的運費總額,用於確保費用行加總到訂單總額。 |
| PRODUCT_AMOUNT | 訂單小計項目 | 訂單的購物車總額,用於確保費用行加總到訂單總額。 |
| DUTY_TAX_AMOUNT | 訂單小計項目 | 預扣前訂單的關稅/稅金總額,用於確保費用行加總到訂單總額。 |
| TAX | 訂單小計項目 | 訂單的稅金總額,用於確保費用行加總到訂單總額。為稅務匯款預扣。 |
| DUTY | 訂單小計項目 | 訂單的關稅總額,用於確保費用行加總到訂單總額。為稅務匯款預扣。 |
| GUARANTEE_PERCENT | Zonos 計費費用 | 關稅和稅金的基於百分比的保證手續費。 |
| GUARANTEE_ORDER | Zonos 計費費用 | 每筆訂單的定額保證手續費。 |
| TRANSACTION_ORDER | Zonos 計費費用 | 每筆訂單的定額交易手續費。 |
| TRANSACTION_PERCENT | Zonos 計費費用 | 基於百分比的交易手續費。 |
交易類型
付款報告包括不同類型的交易:
| 交易類型↕ | 說明↕ |
|---|---|
| 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。
{ "payoutId": "payout_xxxxxxxxxxxxx", "eventType": "ORDER_PAYOUT_DETAILS_READY"}查詢付款詳細資訊
將 payoutId 傳遞至 orderPayoutDetails 查詢。它會傳回 OrderPayoutDetailItem 逐行項目的分頁連結—每筆交易一列—鏡像 Payout detail CSV 報告,涵蓋於上面的 匯出 CSV 報告。
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 } }}連結也會公開 totalAmount 欄位—可見於您組織的 amount 總和—因此您可以取得付款總額,而不需要自己合計每頁。
查看付款
瞭解如何存取及理解您的 Checkout 付款詳細資訊。
在 Zonos Dashboard 中輕鬆存取及查看您的付款報告。在使用 Zonos Checkout 時,付款會定期產生,提供交易、手續費和淨額的詳細明細。付款以您在設定帳戶時選擇的當地貨幣發出。這些報告可協助您對帳財務紀錄並追蹤您的收益。