Weiterleitung der Netzwerkkosten für PlattformenPrivate Vorschau
Erfahren Sie, wie Sie Netzwerkkosten von einer Plattform auf Ihre verbundenen Konten weiterleiten können.
Netzwerkkosten-Weiterleitung (IC++) ist eine Funktion, mit der Plattformen Netzwerkkosten an ihre verbundenen Konten weitergeben können. So können Sie Ihren verbundenen Konten IC±Preise anbieten, anstatt eine Pauschale für alle Kartenzahlungen abzubuchen.
Stripe bucht die Netzwerkkosten zunächst von Ihrem Plattform-Konto ab. Innerhalb weniger Stunden helfen wir Ihnen, diese Kosten vom Guthaben des verbundenen Kontos zurückzuerhalten und dem Guthaben der Plattform hinzuzufügen, um sicherzustellen, dass die Plattform für die Netzwerkkosten vollständig entschädigt wird. Dies umfasst alle Anpassungen im Zusammenhang mit den Netzwerkkosten, einschließlich nicht transaktionsbezogener Schemagebühren, Rückerstattungen und Anfechtungen.
Verwalten Sie den Status der Weiterleitung von Netzwerkkosten für Ihre verbundenen Konten
Wenn Sie das verbundene Konto in Stripe erstellt haben und Zugriff auf die stripe_ haben, können Sie neue Konten als Netzwerkkosten-Weiterleitung einrichten oder bestehende Konten auf die Netzwerkkosten-Weiterleitung umstellen.
Ein Konto als Netzwerkkosten-Weiterleitung festlegen
Um für ein Konto die Netzwerkkosten-Weitergabe einzustellen, müssen Sie ein neues „Pricing Config Scheme“-Objekt mit dem Typ network_ über die Pricing Config Scheme Create API festlegen:
{ "id": "pcsch_1RtBMrPGj7LS2ZC4NtVvHirY", "object": "pricing_config_scheme", "enabled": true, "ends_at": null, "livemode": true, "pricing_config": "network_costs", "starts_at": 1754502193 }
Dadurch wird das Konto sofort für die Weiterleitung der Netzwerkkosten aktiviert, so dass Stripe damit beginnen kann, die Netzwerkkosten an das verbundene Konto weiterzuleiten. Wenn Sie die Weiterleitung der Netzwerkkosten für ein Konto in der Mitte des Monats aktivieren, werden die Netzwerkkosten ab dem Zeitpunkt der Aktivierung vom verbundenen Konto zurückerhalten, nicht für den gesamten Monat.
Um das Konto zu einem späteren Zeitpunkt zur Netzwerkkosten-Weitergabe einzurichten, können Sie optional den Zeitstempel im Parameter starts_at übergeben. Dies bestimmt den Zeitpunkt, ab dem die Netzwerkkosten auf das verbundene Konto weitergeleitet werden.
Sie können für jedes verbundene Konto jeweils nur ein geplantes Schema erstellen. Wenn Sie versuchen, ein neues Schema zu erstellen, nachdem Sie bereits ein Schema geplant haben, erhalten Sie eine Fehlermeldung des Typs 400. Schemata sind unveränderlich, d.h. Sie müssen geplante Schemata löschen und neu erstellen, um Änderungen vorzunehmen.
Die aktuellen und geplanten Schemata finden Sie im Objekt Pricing Config unter Verwendung der Parameter current_ und next_.
{ "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 } }
Einrichtung eines Kontos als Netzwerkkosten-Weiterleitung rückgängig machen
Sie können die Netzwerkkosten-Weitergabe für Konten aufheben, indem Sie ein neues Preisschema network_ erstellen und es auf „aktiviert = false“ setzen.
{ "id": "pcsch_1RtBSlPGj7LS2ZC4P6VEQe8l", "object": "pricing_config_scheme", "enabled": false, "ends_at": null, "livemode": true, "pricing_config": "network_costs", "starts_at": 1754502559 }
Sobald Sie dieses Schema anwenden, bucht Stripe keine Netzwerkkosten mehr von dem verbundenen Konto ab, d.h. das Konto unterliegt nicht mehr der Preisgestaltung zur Netzwerkkosten-Weiterleitung.
Um ein geplantes Schema zu löschen, verwenden Sie den Endpoint DELETE:
{ "id": "pcsch_1RtBWbPGj7LS2ZC4q5lrEuNG", "object": "pricing_config_scheme", "deleted": true }
Sie können kein Schema löschen, das ein starts_-Datum hat, das in der Vergangenheit liegt. Wenn Sie dies versuchen, gibt Stripe einen 400-Fehler zurück, der Sie auffordert, ein neues Schema zu planen.
Den Status der Weiterleitung der Netzwerkkosten für ein Konto anzeigen
Der „Pricing Config Scheme“-Endpoint current_ gibt das Preisschema zurück, das Sie zu einem bestimmten Zeitpunkt angewendet haben:
{ "id": "pcsch_1RtBSlPGj7LS2ZC4P6VEQe8l", "object": "pricing_config_scheme", "enabled": true, "ends_at": 1754503791, "livemode": true, "pricing_config": "network_costs", "starts_at": 1754502879 }
Wenn Sie diesen Endpoint mit einem current_ Datum vor dem Erstellungsdatum des Kontos aufrufen, gibt Stripe einen 400-Fehler zurück.
Passen Sie die Anwendungsgebühr für Ihre verbundenen Konten an
Bei verbundenen Konten mit gemischter Preisgestaltung fallen in der Regel höhere Anwendungskosten an, um die zugrunde liegenden Netzwerkkosten zu decken. Für verbundene Konten, die für ihre eigenen Netzwerkkosten aufkommen, sind die Anwendungsgebühren in der Regel niedriger. Sie können Ihre Preislogik für Anwendungsgebühren auf eine der beiden folgenden Arten aktualisieren:
- Aktualisieren Sie Ihr internes Preisgestaltungsmodul: Wenn Sie die Logik aufrechterhalten, wie hoch Ihre Anwendungsgebühren für jede Abbuchung und jedes verbundene Konto sind, müssen Sie die bedingte Logik in Ihrem internen Modul hinzufügen, um die Anwendungsgebühren zu senken und den Vertragspreis für ein verbundenes Konto festzulegen, das auch seine eigenen Netzwerkkosten bezahlt.
- Aktualisieren Sie Ihre Preisgestaltung im Plattform-Preistool: Wenn Sie das Plattform-Preistool verwenden, um Ihre Preisstrategie für Anwendungsgebühren umzusetzen, müssen Sie Ihre Strategie bearbeiten, um eine differenzierte Preisgestaltung für Kartenzahlungen für Nutzer/innen mit Netzwerkkosten-Weiterleitung einzubauen. Normalerweise sind die Preise für verbundene Konten mit gemischter und IC+ Preisgestaltung in jeder Hinsicht identisch, mit Ausnahme der Kartenzahlungen, bei denen die Anwendungsgebühr für IC++ und verbundene Konten niedriger sind, weil sie auch die Netzwerkkosten zahlen.
Um Ihre Preisstrategie zu verwalten, empfehlen wir Ihnen:
- Erstellen Sie eine Preisgruppe für Ihre mit IC++ verbundenen Konten.
- Kopieren Sie das Preisschema, das Sie für Nutzer/innen mit Mischtarif verwenden.
- Ändern Sie den Preis für Kartenzahlungen, weisen Sie dieses neue Preisschema der Gruppe der verbundenen IC++ verbundene Konten zu, und fügen Sie dann Ihre IC++ verbundenen Konten der Gruppe hinzu.
Stellen Sie Ihren verbundenen Konten Netzwerkkostenberichte zur Verfügung
Wir stellen Ihnen zwei Berichte zur Verfügung, die Sie mit Ihren verbundenen Konten teilen können, um ihnen zu helfen, ihre Netzwerkkosten zu verstehen:
- IC-Bericht auf Planebene: Dieser Bericht hilft verbundenen Konten, die monatlichen Netzwerkkosten für alle ihre Abbuchungen zu verstehen. Er enthält die Namen der Abwicklungspläne und eine Gesamtsumme der Schemagebühren. Dies ist vergleichbar mit dem, was andere Zahlungsdienstleister anbieten. Dieser Bericht zeigt Daten auf der Ebene des Kalendermonats an.
- IC+ Bericht auf Transaktionsebene: Dieser Bericht hilft verbundenen Konten, die Transaktionskosten auf der Ebene der einzelnen Transaktion zu verstehen. Er gibt Auskunft darüber, welche Abbuchungen zu höheren Netzwerkkosten geführt haben und wie sich Rückerstattungen und angefochtenen Zahlungen auf die Netzwerkkosten auswirken. Dieser Bericht zeigt Daten auf der Ebene des Kalendermonats an.
Sie können wählen, welche Berichte Sie Ihren verbundenen Konten anbieten möchten. Verwenden Sie die Reporting-API zum Abrufen dieser Berichte für jedes verbundene Konto für jeden Kalendermonat. Erfahren Sie mehr darüber, wie Sie einen Bericht über die API abrufen.
{ "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 }
Die Ausführung der IC+ Berichte auf Plan- und Transaktionsebene kann mehrere Minuten in Anspruch nehmen. Wenn der Status in der Antwort des obigen API-Aufrufs ausstehend ist, empfehlen wir Ihnen, einen Event Listener für das Ereignis reporting. hinzuzufügen. Nachdem Sie das Ereignis für den von Ihnen erstellten Berichtslauf erhalten haben, stellen Sie sicher, dass Sie es mit der ID (z.B. frr_) vergleichen, die mit Ihrem Berichtslauf verbunden ist. Erfahren Sie mehr über das empfohlene Integrationsmuster für automatisierte Berichte.
In der folgenden Tabelle finden Sie die wichtigsten Spalten und ihre Beschreibungen zum Verständnis der IC+ Berichte auf Plan- und Transaktionsebene. Diese Berichte helfen verbundenen Konten dabei, ihre zugehörigen Netzwerkkosten zu verfolgen.
| Spaltenname | Beschreibung |
|---|---|
connected_ | ID des verbundenen Kontos. (Beispiel: acct_) |
connected_ | Lesbarer Name des verbundenen Kontos |
network_ | Kategorie der Netzwerkkosten. interchange, card_, discount oder ‘non_transactional_card_scheme’ |
plan_ | Name des Netzwerkkostenplans. (Beispiel: Volume Fee - POS Mastercard Debit/Prepaid) |
fee_ | Beginn des Kalendermonats, in dem die Gebühr angefallen ist. Gemessen in Sekunden seit der Unix-Epoche. |
variable_ | Variable Quote, die für die Preisgestaltung gilt. |
variable_ | Der Gesamtbetrag, auf den variable_ angewendet wurde. |
fixed_ | Pauschalbetrag, der für die Preisgestaltung gilt. |
count | Wie oft fixed_ angefallen ist. |
fee_ | Gesamtbetrag der angefallenen Gebühren, in Höhe von variable_ * variable_ + fixed_ * count |
fee_ | Währungen von fee_, variable_ und fixed_. |
billing_ | Gesamtbetrag, der dem verbundenen Konto in Rechnung gestellt wurde. |
billing_ | Währung des billing_. |
platform_ | ID des Plattformkontos. (Beispiel: acct_) |
In der folgenden Tabelle finden Sie die wichtigsten Spalten und ihre Beschreibungen im Zusammenhang mit den Abrechnungstransaktionen zur Entschädigung der Netzwerkkosten. Machen Sie sich mit diesen Spalten vertraut, um die finanziellen Interaktionen zwischen verbundenen Konten und der Plattform zu klären.
| Spaltenname | Beschreibung |
|---|---|
connected_ | ID des verbundenen Kontos. (Beispiel: acct_) |
connected_ | Lesbarer Name des verbundenen Kontos |
transfer_ | ID der Übertragung oder des Zahlungsobjekts, mit dem die Netzwerkkosten vom Guthaben des verbundenen Kontos gutgeschrieben oder abgebucht wurden. (Beispiel: tr_ oder py_) |
platform_ | ID der Übertragung oder des Zahlungsobjekts, mit dem die Netzwerkkosten vom Guthaben des Plattformkontos gutgeschrieben oder abgebucht wurden. (Beispiel: tr_ oder py_) |
transfer_ | Die Uhrzeit, zu der die Übertragung erstellt wurde. Gemessen in Sekunden seit der Unix-Epoche. |
balance_ | ID der Saldo-Transaktion, die die Änderung des Saldos des verbundenen Kontos durchgeführt hat (zum Beispiel bt_) |
balance_ | Die Uhrzeit, zu der die Saldo-Transaktion erstellt wurde. Gemessen in Sekunden seit der Unix-Epoche. |
automatic_ | ID der automatischen Auszahlung, die die balance_transaction enthält |
fee_ | Die Uhrzeit, zu der die Gebühr erstellt wurde. Gemessen in Sekunden seit der Unix-Epoche. |
charge_ | ID der Abbuchung, mit der diese Gebühr verbunden ist (zum Beispiel: ch_ oder py_) |
source_ | ID der ursprünglichen Belastung, mit der diese Gebühr verbunden ist. Bei Direktbelastungen entspricht dies der ‘charge_id’. Bei Destination Charges handelt es sich um die zugrunde liegende Abbuchung, die auf dem Plattformkonto abgerechnet wird. (Beispiel: ch_) |
refund_ | ID der Rückerstattung, mit der diese Gebühr verbunden ist |
dispute_ | ID der angefochtenen Zahlung, mit der diese Gebühr verbunden ist |
captured_ | Durch die Gebühr erfasster Betrag. Nur in Zeilen mit fee_=platform_ ungleich Null. |
captured_ | Währung des captured_ |
card_ | Marke der Karte, für die diese Gebühr angefallen ist. (Zum Beispiel Visa oder MasterCard) |
bin | BIN-Nummer der Karte, für die diese Gebühr angefallen ist. |
issuing_ | Die Bank, die die Karte, für die diese Gebühr angefallen ist, ausgestellt hat. |
card_ | Die Finanzierungsart der Karte, für die diese Gebühr angefallen ist. (Beispielsweise debit, credit oder prepaid) |
card_ | Der ISO-Ländercode des Landes, in dem die Karte ausgestellt wurde. (Beispiel: US) |
card_ | Boolescher Wert, der angibt, ob die Karte beim Kauf physisch vorhanden war. |
fee_ | ‘network_cost’ oder platform_. |
card_ | Betrag für Kartenorganisationsgebühr angefallen. |
interchange_ | Anfallende Abwicklungs- oder Rabattgebühr. |
non_ | Es fallen Gebühren für nicht transaktionsbezogene Leistungen an. |
platform_ | Es fallen Plattformgebühren an, die Währung wird durch billing_ festgelegt. |
fee_ | Währungen der ‘card_scheme_fee’, interchange_ und ‘non_transactional_card_scheme_fee’. |
billing_ | Gesamtbetrag der Gebühren, die dem verbundenen Konto in Rechnung gestellt wurden. |
billing_ | Währungen der Spalten „billing_amount“ und platform_. |
platform_ | ID des Plattformkontos. (Beispiel: acct_) |
Hier sehen Sie ein Beispiel dafür, wie das Ereignis reporting. aussehen könnte:
{ "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" }
Dann können Sie den Bericht für das verbundene Konto über result_ abrufen:
{ "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 }
Rufen Sie den IC+ Bericht auf Transaktionsebene für ein verbundenes Konto für einen bestimmten Monat ab.
Das Abrufen des IC+ Berichts auf Transaktionsebene ist für ein verbundenes Konto für einen bestimmten Monat möglich. Erfahren Sie mehr darüber, wie Sie einen Bericht über die API ausführen.
{ "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 }
Wir empfehlen Ihnen, sich über das Ereignis reporting. zu informieren.
Dann können Sie den Bericht für das verbundene Konto über result_ abrufen:
{ "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 }
Netzwerkkostendaten mit Sigma und Stripe Data Pipeline analysieren
Sie können in Sigma und Stripe Data Pipeline auf diese Berichtsdaten zugreifen, um benutzerdefinierte Analysen durchzuführen und Netzwerkkostendaten in Ihre bestehenden Workflows zu integrieren. Verwenden Sie die Tabellen connect_ und connect_. In Stripe Data Pipeline sehen neue Plattformen in der Regel innerhalb von 72 Stunden Daten.
Führen Sie diese Abfrage aus, um die ersten 10 Zeilen aus der Tabelle connect_ zurückzugeben:
SELECT * FROM connect_card_payments_fees_plan_level LIMIT 10