DOCS

Payouts

Checkout•
ホームGlobal ecommerce Billing Payouts

支払いを表示

Checkoutの支払い詳細へのアクセスと理解方法を学びます。

Zonos Dashboardで支払いレポートに簡単にアクセスして表示できます。Payoutsは定期的に生成され、Zonos Checkout使用時の取引、手数料、正味金額の詳細内訳を提供します。Payoutsはアカウント設定時に選択した現地通貨で発行されます。これらのレポートは財務記録の照合と収益追跡に役立ちます。

注文詳細やlanded cost計算の内訳などの追加レポートは、Reportsをご覧ください。Downloadable reportsでの使用方法を学びます。

支払いデータへのアクセス 

Dashboardで支払いを検索して表示するには：

  1. Dashboard -> Payouts に移動します。
  2. 表示する支払いを選択します。すぐに表示されない場合は、日付または金額でフィルターして検索を絞り込みます。（dateは支払い到着日です）。
  3. Dashboard内で支払い概要と取引リストを表示します。
  4. 詳細については、Export transactionsをクリックして、Payout summaryまたはPayout detailsのCSVファイルをダウンロードします。
    1. Legacy export: レガシーレポート形式は、新レポートへの移行支援のため、2025年7月31日まで個別支払いページで引き続き利用できます。

複数の支払い

複数の支払いにわたる情報を表示するには：

  1. Dashboard -> Payouts に移動します。
  2. 右上の Export をクリックします。
  3. 希望するレポートタイプを選択します：Payout summary または Payout details。
  4. 日付範囲を調整します。日付範囲は注文取引日に基づきます（支払い到着日ではありません）。
  5. Generate report をクリックします。

支払い概要 

支払いページは高レベルの概要を提供し、レポートをエクスポートせずに主要な詳細をすばやく理解できます。

各支払いは4つのコンポーネントに分かれ、合計されます：

  • Payments: 資金を受け取った取引。
  • Refunds: 資金を返金した取引。
  • Charges: 取引手数料や調整など、支払いから差し引かれた手数料。
  • Credits: 過請求手数料の返金など、支払いに適用された返金。
  • Failed previous payout: 以前の支払いが失敗し、後続の支払いで送金された場合、この行に詳細が含まれます。

各コンポーネントについて、以下の詳細が表示されます：

  • Items: 支払い期間内に買い物客が商品に支払った合計金額。
  • Shipping: 支払い期間内に買い物客が配送に支払った合計金額。
  • Discount: 支払い期間内の注文に適用された割引の合計。
  • Duty, taxes, fees: 支払い期間内に買い物客が関税、税金、その他手数料に支払った合計金額。
  • Guarantee: Zonosが代行で支払ったguaranteed duties、税金、手数料をカバーするためにZonosが回収した合計金額。これらのコストはZonosによって保証されます。
  • Transaction fee: 不正防止を含むCheckoutサービス利用の合計手数料（決済処理手数料を除く）。
  • Merchant fee: 支払いから差し引かれた決済処理手数料の合計。
  • Other: 支払い期間内のその他雑費の合計（memoに詳細）。
  • Total: 支払いの正味合計。

詳細については、CSV reportをエクスポートしてください。

支払いの例

支払い内の取引

支払い内の各取引はTransactionsセクションにリストされます。各取引について、以下の詳細が一目で確認できます：

  • Date: 取引日。
  • Order number: 取引に関連するZonos order number。
  • Items: 買い物客が商品に支払った金額。
  • Shipping: 買い物客が配送に支払った金額。
  • Discount: 注文に適用された割引。
  • Duty, taxes, fees: 買い物客が関税、税金、その他手数料に支払った金額。
  • Guarantee: Zonosが代行で支払うguaranteed duties、税金、手数料をカバーするためにZonosが回収する金額。これらのコストはZonosによって保証されます。
  • Transaction fee: 不正防止を含むCheckoutサービス利用手数料（決済処理手数料を除く）。
  • Merchant fee: 決済処理手数料。
  • Other: 理由を説明するmemo付きの雑費。
  • Total: 支払いに含まれる取引の正味合計。

取引ごとのZonos手数料内訳

取引のorder numberをクリックすると、商品金額、配送コスト、関税、税金、項目別手数料の詳細内訳を表示できます（passthrough costsは表示されません）。手数料が表示されない場合、その取引に適用されない可能性があります（例：返金またはDDU注文）。

CSVレポートのエクスポート 

Payout summaryとPayout detailの2種類のレポートをエクスポートできます。Downloadable reportsページで比較してください。

単一支払いのエクスポート

特定の支払いのCSVをエクスポートするには：

  1. Dashboard -> Payouts に移動します
  2. 特定の支払いをクリックします
  3. 支払いページで Export transactions をクリックします
  4. Payout summary または Payout detail を選択します
  5. その特定の支払いのデータのみがエクスポートされます

複数の支払い期間

複数の支払い期間にまたがるCSVをエクスポートするには：

  1. Dashboard -> Payouts に移動します
  2. 右上の Export をクリックします
  3. Payout summary または Payout detail を選択します
  4. 日付範囲を選択します（注文取引日に基づく）
  5. Generate report をクリックします。

注記： レガシーレポート形式は、新レポートへの移行支援のため、2025年7月31日まで個別支払いページで引き続き利用できます。

レポートタイプ

Payout summary report

Payout summary reportは各注文の包括的なビューを提供します。各注文が1行でリストされ、個別の注文合計と手数料を簡単に追跡できます。このレポートは迅速な照合と、各注文で受け取る正味金額の理解に最適です。以下はレポートの列リストです：

列↕説明↕
account_nameZonosアカウント名
payout_date支払い処理日
arrival_date口座到着日
payout_number支払いの一意識別子
payout_total支払い合計金額
currency支払いの通貨コード（例：USD）
transaction_id取引の一意識別子
transaction_date取引発生日
order_numberZonos order identifier
order_referenceプラットフォームの注文参照番号
order_date注文日
transaction_type取引タイプ（ORDER、ORDER_REFUND、ORDER_CANCEL）
item_order買い物客が商品に支払った合計金額
shipping_order買い物客が配送に支払った合計金額
discount_order注文に適用された割引
duty_tax_fee_order買い物客が関税、税金、その他手数料に支払った合計金額
guaranteeZonosがguaranteed duties、税金、手数料をカバーするために回収した合計金額
transaction_feeCheckoutサービス利用の合計手数料
merchant_fee決済処理手数料の合計
other詳細を提供するmemo付きの雑費
settled注文の最終決済金額
memo取引に関する追加情報

Payout detail report

summary reportに加え、各支払いのより詳細なdetails reportをダウンロードできます。このレポートは支払いに関連する取引と手数料の行ごとの内訳を提供します。ネットになるコスト（買い物客が支払いZonosが事業者に代わって納付する税金など）はこのレポートに含まれません。各charge typeが独自の行でリストされるため、注文ごとに複数行になることがよくあります。details reportは財務記録の照合と各取引に関連する手数料の理解に役立ちます。

Payout detail charge types

payout detail reportに表示される可能性のある明細行とその説明のリスト：

Charge type↕タイプ↕説明↕
ZONOS_MERCHANT_PROCESSINGZonos billing fee決済処理のmerchant fee。
ZONOS_TRANSACTIONZonos billing feeZonos Checkout transaction fee。
CURRENCY_CONVERSION_FEEZonos billing fee外国為替リスクのFX forward premium。
ZONOS_LANDED_COSTZonos billing feeZonos Landed Cost Guarantee fee。
ZONOS_LANDED_COST_GUARANTEEZonos billing feelanded cost計算のguarantee fee。
ADVANCEMENTCarrier fee配送キャリアによる請求—詳細はPayout memo列を参照。
BROKERAGE_FEECarrier fee配送キャリアによる請求—詳細はPayout memo列を参照。
SHIPPING_AMOUNTOrder subtotal item注文の配送合計。charge行が注文合計に一致するよう使用。
PRODUCT_AMOUNTOrder subtotal item注文のカート合計。charge行が注文合計に一致するよう使用。
DUTY_TAX_AMOUNTOrder subtotal item控除前の注文関税・税金合計。charge行が注文合計に一致するよう使用。
TAXOrder subtotal item注文の税金合計。charge行が注文合計に一致するよう使用。tax remittanceのため控除。
DUTYOrder subtotal item注文の関税合計。charge行が注文合計に一致するよう使用。tax remittanceのため控除。
GUARANTEE_PERCENTZonos billing fee関税・税金のパーセンテージベースguarantee fee。
GUARANTEE_ORDERZonos billing fee注文ごとの定額guarantee fee。
TRANSACTION_ORDERZonos billing fee注文ごとの定額transaction fee。
TRANSACTION_PERCENTZonos billing feeパーセンテージベースtransaction fee。

Transaction Types

支払いレポートにはさまざまな取引タイプが含まれます：

Transaction Type↕説明↕
ORDER資金を受け取った通常の注文取引。
ORDER_REFUND顧客に資金を返金した取引。
ORDER_CANCEL処理前にキャンセルされた注文の取引。
Charge注文に関連付けられないcharge取引。
Credit注文に関連付けられない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クエリに渡します。取引ごとに1行のOrderPayoutDetailItem line itemsのページネーション接続を返し、上記Export CSV reportsで説明したPayout detail CSV reportを反映します。

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フィールドも公開し、組織に表示されるline itemsのamount合計を提供するため、すべてのページを自分で合計せずに支払い合計を取得できます。

大規模支払いのページネーション

1つの支払いには多数の取引が含まれる場合があります。firstとafter引数を使用して結果をページングし、pageInfo.hasNextPageがfalseになるまでpageInfo.endCursorに従います。

デモを予約する

このページは役に立ちましたか？

サポートを受ける·法的文書·© 2026 Zonos
このページでは：
  • CSVレポートのエクスポート
  • APIで支払い詳細を取得