コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン

プラットフォームのためのネットワークコストパススルー非公開プレビュー

プラットフォームから連結アカウントにネットワークコストを渡す方法をご紹介します。

ネットワークコストパススルー (IC++) は、プラットフォームがネットワークコストを連結アカウントに転嫁するケイパビリティです。これにより、すべてのカード決済に対して混合レートを請求するのではなく、IC+ の料金体系を連結アカウントに提供できます。

Stripe はまず、プラットフォームアカウントにネットワークコストを請求します。数時間以内に、連結アカウントの残高からこれらのコストを回収し、プラットフォームの残高に追加して、プラットフォームがネットワークコストを完全に補填できるようにします。これには、取引以外のブランドフィー、返金、不審請求の申し立てなど、ネットワークコストに関連するすべてのネットワークコスト調整が含まれます。

連結アカウントのネットワークコストパススルーステータスを管理する

Stripe で連結アカウントを作成し、stripe_account_id にアクセスできる場合は、新しいアカウントをネットワークコストパススルーとして設定したり、既存のアカウントをネットワークコストパススルーに移行したりできます。

ネットワークコストパススルーとしてアカウントを設定する

アカウントをネットワークコストパススルーとして設定するには、Pricing Config Scheme Create API を使用して、network_costs タイプで新しい Pricing Config Scheme オブジェクトをスケジュールする必要があります。

Command Line
cURL
No results
curl https://api.stripe.com/v1/pricing_configs/network_costs/schemes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.preview; network_costs_private_preview=v1" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d enabled=true
{
  "id": "pcsch_1RtBMrPGj7LS2ZC4NtVvHirY",
  "object": "pricing_config_scheme",
  "enabled": true,
  "ends_at": null,
  "livemode": true,
  "pricing_config": "network_costs",
  "starts_at": 1754502193
}

これにより、ネットワークコストパススルーのアカウントが直ちに設定され、Stripe は連結アカウントへのネットワークコストパススルーを開始できます。月の途中にアカウントでネットワークコストパススルーを有効にした場合、ネットワークコストは月全体ではなく、有効化された時点から連結アカウントから回収されます。

オプションで、将来の日付でアカウントをネットワークコストパススルーとして設定するには、starts_at パラメータでタイムスタンプを渡すことができます。これにより、連結アカウントにネットワークコストパススルーを開始する時間が決まります。

連結アカウントごとに一度に作成できるスケジュール済みスキームは 1 つだけです。スケジュール済みスキームがすでに 1 つあるときに新しいスキームを作成しようとすると、400 エラーが発生します。スキームは変更できないため、変更するにはスケジュール済みスキームを削除して再作成する必要があります。

current_scheme および next_scheme パラメータを使用して、Pricing Config オブジェクトで現在およびスケジュール済みのスキームを確認できます。

Command Line
cURL
No results
curl -G https://api.stripe.com/v1/pricing_configs/network_costs \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.preview; network_costs_private_preview=v1" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "expand[]"=current_scheme \
  -d "expand[]"=next_scheme
{
  "id": "network_costs",
  "object": "pricing_config",
  "current_scheme": {
    "id": "pcsch_1RtBSlPGj7LS2ZC4P6VEQe8l",
    "object": "pricing_config_scheme",
    "enabled": false,
    "ends_at": 1754614254,
    "livemode": true,
    "pricing_config": "network_costs",
    "starts_at": 1754502559
  },
  "livemode": true,
  "next_scheme": {
    "id": "pcsch_1RtBhkPGj7LS2ZC4U7LWEvLX",
    "object": "pricing_config_scheme",
    "enabled": true,
    "ends_at": null,
    "livemode": true,
    "pricing_config": "network_costs",
    "starts_at": 1754614254
  }
}

ネットワークコストパススルーとしてのアカウントの設定解除

アカウントをネットワークコストパススルーとして設定解除するには、新しい network_costs 料金体系を作成し、それを enabled = false に設定します。

Command Line
cURL
No results
curl https://api.stripe.com/v1/pricing_configs/network_costs/schemes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.preview; network_costs_private_preview=v1" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d enabled=false
{
  "id": "pcsch_1RtBSlPGj7LS2ZC4P6VEQe8l",
  "object": "pricing_config_scheme",
  "enabled": false,
  "ends_at": null,
  "livemode": true,
  "pricing_config": "network_costs",
  "starts_at": 1754502559
}

このスキームを適用すると、Stripe は連結アカウントにネットワークコストを請求しません。つまり、アカウントはネットワークコストパススルー料金体系ではなくなります。

スケジュール済みのスキームを削除するには、DELETE エンドポイントを使用します。

Command Line
cURL
No results
curl -X DELETE https://api.stripe.com/v1/pricing_configs/network_costs/schemes/pcsch_1RtBWbPGj7LS2ZC4q5lrEuNG \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.preview; network_costs_private_preview=v1" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"
{
  "id": "pcsch_1RtBWbPGj7LS2ZC4q5lrEuNG",
  "object": "pricing_config_scheme",
  "deleted": true
}

starts_at の日付が過去のスキームは削除できません。削除しようとすると、Stripe は新しいスキームをスケジュールするように求める 400 エラーを返します。

アカウントのネットワークコストパススルーステータスを表示する

Pricing Config Scheme current_at エンドポイントは、特定のタイムスタンプに適用した料金体系を返します。

Command Line
cURL
No results
curl -G https://api.stripe.com/v1/pricing_configs/network_costs/schemes/current_at \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.preview; network_costs_private_preview=v1" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d current_at=1754502879
{
  "id": "pcsch_1RtBSlPGj7LS2ZC4P6VEQe8l",
  "object": "pricing_config_scheme",
  "enabled": true,
  "ends_at": 1754503791,
  "livemode": true,
  "pricing_config": "network_costs",
  "starts_at": 1754502879
}

アカウントの作成日より前の日付に current_at を指定してこのエンドポイントを呼び出すと、Stripe は 400 エラーを返します。

連結アカウントのプラットフォーム手数料を調整する

混合料金体系の連結アカウントは、通常、基礎となるネットワークコストをカバーするためにプラットフォーム手数料が高く、ネットワークコストを自身で支払う連結アカウントは通常、プラットフォーム手数料が低くなります。プラットフォーム手数料の料金体系ロジックは、次の 2 つの方法のいずれかで更新できます。

  1. 内部価格エンジンの更新: 各支払いと連結アカウントのプラットフォーム手数料の料金設定ロジックを維持する場合は、内部エンジンに条件付きロジックを追加してプラットフォーム手数料を下げ、ネットワークコストも支払う連結アカウントの契約価格を設定する必要があります。
  2. プラットフォーム料金体系ツールで料金体系を更新する: プラットフォーム料金体系ツールを使用してプラットフォーム手数料の料金体系戦略を実行する場合、ネットワークコストパススルーに設定されたユーザー向けのカード決済に差別化された料金体系を組み込むように戦略を編集する必要があります。通常、混合料金と IC+ 料金の連結アカウントの料金体系は、カード決済を除き、あらゆる面で同一です。カード決済では、IC++ 料金の連結アカウントのプラットフォーム手数料は低くなっています。これは、ネットワークコストも支払うためです。

料金戦略を管理するために、以下を行うことをお勧めします。

  1. IC++ 連結アカウントの料金グループを作成します。
  2. 混合レートのユーザーに使用する料金体系をコピーします。
  3. カード決済価格を変更し、その新しい料金体系を IC++ 連結アカウントグループに割り当て、IC++ 連結アカウントをグループに追加します。

連結アカウントにネットワークコストレポートを提供する

連結アカウントがネットワークコストを把握できるように、2 つのレポートを提供しています。

  • IC プランレベルのレポート: このレポートは、連結アカウントがすべての支払いの月次のネットワークコストを把握するのに役立ちます。インターチェンジプラン名と合計ブランドフィーが表示されます。これは、他の決済代行業者が提供するものと似ています。このレポートには、暦月レベルのデータが表示されます。
  • IC+ 取引レベルのレポート: このレポートは、連結アカウントが個別の取引レベルで取引コストを把握するのに役立ちます。ネットワークコストの増加につながった支払いと、返金や不審請求の申し立てがネットワークコストに与える影響に関する情報を提供します。このレポートは、暦月レベルのデータを示します。

連結アカウントに提供するレポートを選択できます。Reporting API を使用して、各連結アカウントの各暦月のレポートを実行します。API からのレポート実行の詳細をご確認ください。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/reporting/report_runs \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d report_type="connect_card_payments_fees.plan_level.1" \
  -d "parameters[interval_start]"=1680000000 \
  -d "parameters[interval_end]"=1680100000
{
  "id": "frr_1RmMIdPHHHwdjQjw3kOoBamc",
  "object": "reporting.report_run",
  "created": 1752875919,
  "error": null,
  "livemode": true,
  "parameters": {
    "interval_end": 1680100000,
    "interval_start": 1680000000
  },
  "report_type": "connect_card_payments_fees.plan_level.1",
  "result": {
    "id": "file_1RmM67PHHHwdjQjwvvCB2JwD",
    "object": "file",
    "created": 1752875143,
    "expires_at": 1784411143,
    "filename": "frr_1RmM5wPHHHwdjQjwgfvy9rXJ.csv",
    "links": {
      "object": "list",
      "data": [],
      "has_more": false,
      "url": "/v1/file_links?file=file_1RmM67PHHHwdjQjwvvCB2JwD"
    },
    "purpose": "finance_report_run",
    "size": 464,
    "title": "FinanceReportRun frr_1RmM5wPHHHwdjQjwgfvy9rXJ",
    "type": "csv",
    "url": "https://files.stripe.com/v1/files/file_1RmM67PHHHwdjQjwvvCB2JwD/contents"
  },
  "status": "succeeded",
  "succeeded_at": 1752875919
}

IC+ プランレベルおよび取引レベルのレポートの実行には数分かかる場合があります。上記の API コールからの応答のステータスが保留中の場合は、reporting.report_run.succeeded イベントのイベントリスナーを追加することをお勧めします。作成したレポート実行のイベントを受信したら、それをレポート実行に関連付けられた ID (frr_... など) と比較してください。自動レポートの推奨導入パターンの詳細をご確認ください。

次の表は、IC+ プランレベルおよび取引レベルのレポートを理解するための主な列とその説明を示しています。これらのレポートは、連結アカウントが関連するネットワークコストを追跡するのに役立ちます。

列名説明
platform_id支払いを処理するプラットフォームの ID。
connected_account_id支払いが処理され、最終的にネットワークコストを支払った連結アカウントの ID。
connected_account_name支払いが処理された連結アカウントの名前、およびネットワークコストを最終的に支払った連結アカウントの名前。
plan_nameインターチェンジプランの名前。すべてのスキームプランは、スキーム手数料と呼ばれる 1 行に集約されます。
variable_rate特定のプランに対してネットワークから請求される変動レート。
variable_volume特定のプランのネットワークコストについて評価された金額。
fixed_rate特定のプランで評価された金額に関連する固定手数料。
count特定のプランのネットワークコストについて評価された支払い件数。
fee_amount請求されるネットワークコストの合計金額。
fee_currency請求されるネットワークコスト手数料の通貨。
network_cost_category請求されるネットワークコストのカテゴリ。card_scheme または interchange_or_discount のいずれか。
billing_amount税金を含む、通貨換算後の Stripe 残高から差し引かれるこの手数料の合計金額。billing_currency の主要単位で示されます。
billing_currencyこの手数料で Stripe 残高から引き落とされる通貨の 3 文字の ISO コード。

次の表は、ネットワークコストの回収に関連する請求取引に関連する主要な列とその説明をまとめたものです。これらの列を理解することで、連結アカウントとプラットフォーム間の財務上のやり取りを明確にすることができます。

列名説明
connected_account_id支払いが処理された連結アカウントの ID、およびネットワークコストを最終的に支払ったアカウントの ID。
connected_account_name支払いが処理された連結アカウントの ID、およびネットワークコストを最終的に支払ったアカウントの ID。
balance_transaction_idプラットフォームによって回収されたネットワークコスト手数料の取引残高の一意の識別子。
balance_transaction_createdプラットフォームによって回収されたネットワークコストの取引残高が作成された日時のタイムスタンプ。
automatic_payout_idこの取引残高に関連付けられた自動作成された入金の ID (アカウントが自動入金スケジュールの場合にのみ設定されます)。
fee_incurred_atこの手数料が発生したイベントの時刻 (UTC)。
charge_id連結アカウントに表示される支払いの一意の ID。連結アカウントで決済される支払いの場合、このフィールドには支払いの ID の値が含まれます。プラットフォームで決済され、連結アカウントに送金される支払いの場合、このフィールドには送金の値が含まれます。
source_transaction_id関連する支払い (存在する場合) の一意の ID。支払いの場合、これは支払い自体です。返金または不審請求の申し立ての場合、これは返金または不審請求の申し立てが行われる元の支払いです。
captured_amount支払いでキャプチャーされた金額。
captured_currencyキャプチャーされた金額の通貨。
refund_id関連する返金の固有の ID (存在する場合)。
dispute_id関連する不審請求の申し立て (存在する場合) の固有の ID。
card_brandカードブランド (該当する場合)。
bin取引で使用されたカードに関連付けられた銀行識別番号 (BIN)。BIN はカードを発行した銀行に関連付けられています。BIN を使用して、カード発行会社とカード自体に関する情報を検索できます。
transfer_id連結アカウントとプラットフォーム間のネットワークコストの回収をキャプチャーする送金オブジェクトの ID。
platform_transfer_id連結アカウントからネットワークコストを受け取るプラットフォームの送金オブジェクトの ID。これはプラットフォームにのみ関連します。
transfer_createdネットワークコスト回収のための連結アカウントとプラットフォーム間の送金のタイムスタンプ。
issuing_bankカードを発行した銀行の名前。通常、Stripe で使用できます (常に使用できるわけではありません)。
card_fundingカードの資金供給タイプ (該当する場合)。
card_countryカードの国を表す 2 文字の ISO コード。
card_presenttrueの場合、この手数料に関連する支払いが、磁気ストライプスワイプまたは EMV チップの読み取りによって開始されたことを示します。
fee_categoryplatform_fee (プラットフォームによって請求されるプラットフォーム手数料を示す) または network_cost (決済ネットワークによって設定された手数料を示す) のいずれか。
card_scheme_fee特定の支払いに関連する取引スキーム手数料。
interchange_or_discount_fee支払いに関連するインターチェンジ手数料または割引手数料。
non_transactional_card_scheme_fee支払いに関連する取引以外のカードブランドフィー。
platform_application_feeこの支払いに対してプラットフォームから請求されるプラットフォーム手数料。
billing_amount税金を含む、通貨換算後の Stripe 残高から差し引かれるこの手数料の合計金額。billing_currency の主要単位で示されます。
billing_currencyこの手数料で Stripe 残高から引き落とされる通貨の 3 文字の ISO コード。

reporting.report_run.succeeded イベントの例を次に示します。

{
  "id": "evt_1RtCRKPHHHwdjQjwfRPzuvep",
  "object": "event",
  "account": "acct_1234",
  "api_version": "2025-07-30.preview; network_costs_private_preview=v1",
  "context": "acct_1234",
  "created": 1754506314,
  "data": {
    "object": {
      "id": "frr_1RmMIdPHHHwdjQjw3kOoBamc",
      "object": "reporting.report_run",
      "created": 1754503324,
      "error": null,
      "livemode": true,
      "parameters": {
        "interval_end": 1751328000,
        "interval_start": 1748736000
      },
      "report_type": "connect_card_payments_fees.plan_level.1",
      "result": {
        "id": "file_1RtCRKPHHHwdjQjwDeGKimBi",
        "object": "file",
        "created": 1754506314,
        "expires_at": 1786042314,
        "filename": "frr_1RtBf6PHHHwdjQjwgr4SWj6Q.csv",
        "links": {
          "object": "list",
          "data": [],
          "has_more": false,
          "url": "/v1/file_links?file=file_1RtCRKPHHHwdjQjwDeGKimBi"
        },
        "purpose": "finance_report_run",
        "size": 748,
        "title": "FinanceReportRun frr_1RtBf6PHHHwdjQjwgr4SWj6Q",
        "type": "csv",
        "url": "https://files.stripe.com/v1/files/file_1RtCRKPHHHwdjQjwDeGKimBi/contents"
      },
      "status": "succeeded",
      "succeeded_at": 1754506314
    }
  },
  "livemode": true,
  "pending_webhooks": 1,
  "request": {
    "id": null,
    "idempotency_key": null
  },
  "type": "reporting.report_run.succeeded"
}

次に、result_url を使用して連結アカウントのレポートを取得できます。

Command Line
curl
No results
curl https://files.stripe.com/v1/files/file_1RtCRKPHHHwdjQjwDeGKimBi/contents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
{
  "platform_id": "acct_1GcldzAppfGnVJgH",
  "connected_account_id": "acct_1PzmZGPHHHwdjQjw",
  "connected_account_name": null,
  "plan_name": "All scheme fees",
  "network_cost_category": "card_scheme",
  "total_amount": "0.005991",
  "fee_currency": "usd",
  "livemode": true
  },
  {
    "platform_id": "acct_1GcldzAppfGnVJgH",
    "connected_account_id": "acct_1PzmZGPHHHwdjQjw",
    "connected_account_name": null,
    "plan_name": "CPS Services",
    "network_cost_category": "interchange",
    "total_amount": "0.025750",
    "fee_currency": "usd",
    "livemode": true
  },
  {
    "platform_id": "acct_1GcldzAppfGnVJgH",
    "connected_account_id": "acct_1PzmZGPHHHwdjQjw",
    "connected_account_name": null,
    "plan_name": "Visa Traditional - Product 1",
    "network_cost_category": "interchange",
    "total_amount": "0.016175",
    "fee_currency": "usd",
    "livemode": true
  }

特定の月の連結アカウントの IC+ 取引レベルのレポートを取得する

特定の月の連結アカウントの IC+ 取引レベルレポートを生成できます。API からのレポート実行について詳細をご覧ください。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/reporting/report_runs \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d report_type="connect_card_payments_fees.transaction_level.1" \
  -d "parameters[interval_start]"=1680000000 \
  -d "parameters[interval_end]"=1680100000
{
  "id": "frr_1RmMK3PHHHwdjQjw0pJ2Nsga",
  "object": "reporting.report_run",
  "created": 1752876007,
  "error": null,
  "livemode": true,
  "parameters": {
    "interval_end": 1680100000,
    "interval_start": 1680000000
  },
  "report_type": "connect_card_payments_fees.transaction_level.1",
  "result": {
    "id": "file_1RmM8wPHHHwdjQjwkHoUYySJ",
    "object": "file",
    "created": 1752875318,
    "expires_at": 1784411318,
    "filename": "frr_1RmM8sPHHHwdjQjwHgTQ3dlv.csv",
    "links": {
      "object": "list",
      "data": [],
      "has_more": false,
      "url": "/v1/file_links?file=file_1RmM8wPHHHwdjQjwkHoUYySJ"
    },
    "purpose": "finance_report_run",
    "size": 6307,
    "title": "FinanceReportRun frr_1RmM8sPHHHwdjQjwHgTQ3dlv",
    "type": "csv",
    "url": "https://files.stripe.com/v1/files/file_1RmM8wPHHHwdjQjwkHoUYySJ/contents"
  },
  "status": "succeeded",
  "succeeded_at": 1752876007
}

reporting.report_run.succeeded イベントをリッスンすることを推奨します。

次に、result_url を使用して連結アカウントのレポートを取得できます。

Command Line
curl
No results
curl https://files.stripe.com/v1/files/file_1RmM8wPHHHwdjQjwkHoUYySJ/contents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
{
  "platform_id": "acct_1GcldzAppfGnVJgH",
  "connected_account_id": "acct_1PzmZGPHHHwdjQjw",
  "connected_account_name": null,
  "transfer_id": "tr_1RWQcfPHHHwdjQjwZtsZqox6",
  "transfer_created": "2025-06-04T23:21:32.000Z",
  "balance_transaction_id": "txn_1RWQckPHHHwdjQjwRZSrO0tE",
  "balance_transaction_created": "2025-06-04T23:21:32.000Z",
  "automatic_payout_id": "po_1RXu75PHHHwdjQjwNGy9TPIx",
  "fee_incurred_at": "2025-06-02T16:48:13.000Z",
  "charge_id": "ch_3RTq8hPHHHwdjQjw1qxQ9aBj",
  "captured_amount": null,
  "captured_currency": null,
  "refund_id": "re_3RTq8hPHHHwdjQjw1QQUI2VO",
  "dispute_id": null,
  "card_brand": "MasterCard",
  "bin": "545660",
  "issuing_bank": "SUTTON BANK",
  "card_funding": "prepaid",
  "card_country": "US",
  "card_present": false,
  "fee_category": "network_cost",
  "card_scheme_fee": "0.000203",
  "interchange_fee": "0.000000",
  "non_transactional_card_scheme_fee": "0.000000",
  "discount_fee": "0.000000",
  "platform_application_fee": "0.000000",
  "total_amount": "0.000203",
  "fee_currency": "usd",
  "livemode": true
  },
  {
   "platform_id": "acct_1GcldzAppfGnVJgH",
  "connected_account_id": "acct_1PzmZGPHHHwdjQjw",
    "connected_account_name": null,
    "transfer_id": "tr_1RWMxzPHHHwdjQjwOH8PHSiq",
    "transfer_created": "2025-06-04T19:27:15.000Z",
    "balance_transaction_id": "txn_1RWMxzPHHHwdjQjwwZu9lZMg",
    "balance_transaction_created": "2025-06-04T19:27:15.000Z",
    "automatic_payout_id": "po_1RXu75PHHHwdjQjwNGy9TPIx",
    "fee_incurred_at": "2025-06-02T16:49:15.000Z",
    "charge_id": "ch_3RTq8hPHHHwdjQjw1qxQ9aBj",
    "captured_amount": null,
    "captured_currency": null,
    "refund_id": "re_3RTq8hPHHHwdjQjw1QQUI2VO",
    "dispute_id": null,
    "card_brand": "MasterCard",
    "bin": "545660",
    "issuing_bank": "SUTTON BANK",
    "card_funding": "prepaid",
    "card_country": "US",
    "card_present": false,
    "fee_category": "network_cost",
    "card_scheme_fee": "0.000218",
    "interchange_fee": "0.000000",
    "non_transactional_card_scheme_fee": "0.000000",
    "discount_fee": "0.000000",
    "platform_application_fee": "0.000000",
    "total_amount": "0.000218",
    "fee_currency": "usd",
    "livemode": true
  }
このページはお役に立ちましたか。
はいいいえ