コンテンツにスキップ
アカウント作成/サインイン
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+ プランレベルおよび取引レベルのレポートを理解するための主な列とその説明を示しています。これらのレポートは、連結アカウントが関連するネットワークコストを追跡するのに役立ちます。

列名説明
connected_account_id連結アカウントの ID。(例: acct_1234)
connected_account_name連結アカウントの表示名
network_cost_categoryネットワークコストのカテゴリ。interchange、card_scheme、discount、または「non_transactional_card_scheme」
plan_nameネットワークの料金プランの名前。(例: Volume Fee - POS Mastercard Debit/Prepaid)
fee_incurred_month手数料が発生したカレンダー月の開始時刻。Unix エポックからの経過秒数で表されます。
variable_rate料金プランに適用される変動料金。
variable_volume_amountvariable_rate が適用された合計金額。
fixed_rate料金プランに適用される固定料金額。
countfixed_rate が発生した回数。
fee_amount発生した合計手数料額。計算式は variable_rate * variable_volume_amount + fixed_rate * count に等しい
fee_currencyfee_amount、variable_volume_amount、fixed_rate の通貨
billing_amount連結アカウントに請求された合計金額。
billing_currencybilling_amount の通貨
platform_idプラットフォームアカウントのID。(例: acct_1234)

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

列名説明
connected_account_id連結アカウントの ID。(例: acct_1234)
connected_account_name連結アカウントの表示名
transfer_id連結アカウントの残高からネットワークコストを入金または引き落とした振替または支払いオブジェクトの ID。(例えば、tr_1234 又は py_1234)
platform_transfer_idプラットフォームアカウントの残高からネットワークコストを入金または引き落とした振替または支払いオブジェクトの ID。(例: tr_1234 または py_1234)
transfer_created振替が作成された時刻。Unix エポックからの経過秒数で表されます。
balance_transaction_id連結口座の残高に変更を加えた残高取引 ID (例: bt_1234)
balance_transaction_created残高取引が作成された時刻。Unix エポックからの経過秒数で表されます。
automatic_payout_idbalance_transaction を含む自動出金の ID
fee_incurred手数料が発生した時刻。Unix エポックからの経過秒数で表されます。
charge_idこの手数料に関連する請求 ID (例: ch_1234 または py_1234)
source_transaction_idこの手数料に紐づく元のチャージの ID。ダイレクト支払いの場合、「charge_id」と同じ値です。Destination の手数料の場合、プラットフォームアカウントで清算される基礎チャージの ID です。(例: ch_1234)
refund_idこの手数料に関連する返金の ID
dispute_idこの手数料に関連する不審請求の ID
captured_amount課金で確定された金額。fee_category=platform_fee の行のみ、ゼロ以外の値を持ちます。
captured_currencycaptured_amount の通貨
card_brandこの手数料がかかるカードのブランド。(例: ば、Visa、または MasterCard)
binこの手数料がかかったカードの BIN 番号。
issuing_bankこの手数料が発生したカードを発行した銀行。
card_fundingこの手数料が発生したカードの入金の種類。(例: デビット、クレジット、または プリペイド)
card_countryカードが発行された国の ISO 国コードです。(例: US)
card_present購入時にカードが物理的に提示されたかどうかを示す真偽値
fee_category「network_cost」または platform_fee。
card_scheme_fee発生したスキーム手数料の金額。
interchange_or_discount_fee発生した交換手数料または割引手数料の金額。
non_transactional_card_scheme_fee発生した非取引スキーム手数料の金額。
platform_application_fee発生したプラットフォーム申請手数料。通貨は billing_currency で指定されます。
fee_currency「card_scheme_fee」、interchange_or_discount_fee、そして「non_transactional_card_scheme_fee」の通貨。
billing_amount連結アカウントに請求された手数料の総額。
billing_currency「billing_amount」および platform_application_fee 列の通貨。
platform_idプラットフォームアカウントのID。(例: acct_1234)

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
  }

Sigma と Stripe Data Pipeline でネットワークコストデータを分析

このレポートデータには Sigma と Stripe Data Pipeline でアクセスして、カスタム分析を実行したり、ネットワークコストデータを既存のワークフローに連携したりすることができます。connect_card_payments_fees_plan_level テーブルと connect_card_payments_fees_transaction_level テーブルを使用します。Stripe Data Pipeline では、新しいプラットフォームでは通常、72 時間以内にデータが確認できます。

このクエリを実行すると、connect_card_payments_fees_plan_level テーブルの最初の10行を返します。

SELECT *
FROM connect_card_payments_fees_plan_level
LIMIT 10