Répercussion des coûts de réseau pour les plateformesVersion bêta privée

Découvrez comment transférer les coûts de réseau d'une plateforme à vos comptes connectés.

Le transfert des coûts de réseau (IC++) est une fonctionnalité permettant aux plateformes de répercuter les coûts de réseau sur leurs comptes connectés. Cela vous permet de proposer la tarification IC+ à vos comptes connectés au lieu de facturer un tarif mixte pour tous les paiements par carte.

Stripe prélève d’abord les coûts de réseau sur le compte de votre plateforme. En quelques heures, nous vous aidons à récupérer ces coûts à partir du solde du compte connecté et à les ajouter au solde de la plateforme, afin de nous assurer que la plateforme est entièrement compensée pour les coûts de réseau. Cela inclut tous les ajustements des coûts de réseau liés aux coûts de réseau, y compris les frais de réseau non transactionnels, les remboursements et les litiges.

Gérer l'état de transfert des coûts de réseau pour vos comptes connectés

Si vous avez créé le compte connecté dans Stripe et que vous avez accès au stripe_account_id, vous pouvez définir de nouveaux comptes en tant que transfert de coûts de réseau ou faire passer les comptes existants au transfert de coûts de réseau.

Définir un compte comme transfert de coûts de réseau

Pour définir un compte comme répercussion des coûts de réseau, vous devez planifier un nouvel objet Pricing Config Scheme avec le type network_costs à l’aide de l’API Price Config Scheme Create :

{
  "id": "pcsch_1RtBMrPGj7LS2ZC4NtVvHirY",
  "object": "pricing_config_scheme",
  "enabled": true,
  "ends_at": null,
  "livemode": true,
  "pricing_config": "network_costs",
  "starts_at": 1754502193
}

Cela définit immédiatement le compte pour la répercussion des coûts de réseau, ce qui permet à Stripe de commencer à répercuter les coûts de réseau sur le compte connecté. Si vous activez la répercussion des coûts de réseau sur un compte au milieu du mois, les coûts de réseau sont récupérés sur le compte connecté à partir du moment de l’activation, et non du mois entier.

Si vous le souhaitez, pour définir le compte comme répercussion des coûts de réseau à une date ultérieure, vous pouvez transmettre l’horodatage dans le paramètre starts_at. Cela détermine le moment où les coûts de réseau commencent à être répercutés sur le compte connecté.

Vous ne pouvez créer qu’un seul schéma planifié à la fois pour chaque compte connecté. Si vous tentez de créer un nouveau schéma alors que vous en avez déjà un planifié, une erreur 400 s’affiche. Les schémas sont immuables, ce qui signifie que vous devez supprimer et recréer des schémas planifiés pour effectuer toute modification.

Vous trouverez les schémas actuels et planifiés dans l’objet Pricing Configure à l’aide des paramètres current_scheme et 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
  }
}

Annuler la configuration d’un compte en tant que transfert de coûts de réseau

Vous pouvez déactiver les comptes en tant que répercussion des coûts réseau en créant un nouveau schéma de tarification des coûts réseau et en le définissant sur activé = faux.

{
  "id": "pcsch_1RtBSlPGj7LS2ZC4P6VEQe8l",
  "object": "pricing_config_scheme",
  "enabled": false,
  "ends_at": null,
  "livemode": true,
  "pricing_config": "network_costs",
  "starts_at": 1754502559
}

Une fois que vous avez appliqué ce système, Stripe ne débite pas les coûts de réseau sur le compte connecté, ce qui signifie que le compte ne bénéficie plus de la tarification de transfert des coûts de réseau.

Pour supprimer un schéma planifié, utilisez l’endpoint DELETE :

{
  "id": "pcsch_1RtBWbPGj7LS2ZC4q5lrEuNG",
  "object": "pricing_config_scheme",
  "deleted": true
}

Vous ne pouvez pas supprimer un schéma dont la date starts_at est dans le passé. Si vous tentez de le faire, Stripe renvoie une erreur 400 qui vous invite à planifier un nouveau schéma.

Afficher l’état de la transmission des coûts de réseau pour un compte

The Pricing Config Scheme current_at endpoint returns the pricing scheme that you applied at a specific timestamp:

{
  "id": "pcsch_1RtBSlPGj7LS2ZC4P6VEQe8l",
  "object": "pricing_config_scheme",
  "enabled": true,
  "ends_at": 1754503791,
  "livemode": true,
  "pricing_config": "network_costs",
  "starts_at": 1754502879
}

Si vous appelez cet endpoint avec une date current_at antérieure à la date de création du compte, Stripe renvoie une erreur 400.

Ajuster la commission de plateforme pour vos comptes connectés

Les comptes connectés bénéficiant d’une tarification mixte sont généralement soumis à des commissions de plateforme plus élevées pour couvrir le coût de réseau sous-jacent, et les comptes connectés qui paient leurs propres coûts de réseau paient généralement des commissions de plateforme moins élevées. Vous pouvez mettre à jour votre logique tarifaire pour les commissions de plateforme de l’une des deux manières suivantes :

Mettez à jour votre moteur de tarification interne : si vous maintenez la logique du montant à débiter en commissions de plateforme pour chaque débité et compte connecté, vous devez ajouter la logique conditionnelle dans votre moteur interne afin de faire baisser les commissions de plateforme et de fixer le tarif contractuel pour un compte connecté qui paie également ses propres coûts de réseau.
Mettez à jour votre tarification dans l’outil de tarification de la plateforme : si vous utilisez l’outil de tarification de la plateforme pour exécuter votre stratégie de tarification des commissions de plateforme, vous devez modifier votre stratégie de manière à intégrer une tarification différenciée pour les paiements par carte bancaire pour les utilisateurs définie pour la répercussion des coûts de réseau. En règle générale, les tarifs des comptes connectés à tarification mixte et IC+ sont identiques en tous points, sauf pour les paiements par carte, où les commissions de plateforme des comptes connectés IC++ sont moins élevées parce qu’ils paient également des coûts de réseau.

Pour gérer votre stratégie tarifaire, nous vous recommandons de :

Créez un groupe tarifaire pour vos comptes connectés IC++.
Copiez le modèle tarifaire que vous utilisez pour les utilisateurs de tarifs mixtes.
Modifiez le tarif des paiements par carte, attribuez ce nouveau modèle de tarification au groupe de comptes connectés IC++, puis ajoutez vos comptes connectés IC++ au groupe.

Fournissez des rapports sur les coûts de réseau à vos comptes connectés

Nous fournissons deux rapports que vous pouvez partager avec vos comptes connectés pour les aider à comprendre leurs coûts de réseau :

Rapport au niveau de l’offre IC : ce rapport aide les comptes connectés à comprendre les coûts de réseau mensuels pour tous leurs paiements. Il fournit les noms des offres d’interchange et un total agrégé des frais de réseau. Ce rapport est similaire à celui proposé par d’autres prestataires de services de paiement. Ce rapport présente les données au niveau du mois civil.
Rapport de niveau transaction IC+ : ce rapport aide les comptes connectés à comprendre les coûts de transaction au niveau d’une transaction donnée. Il fournit des informations sur les paiements qui ont entraîné une hausse des coûts de réseau et sur l’impact des remboursements et des litiges sur les coûts de réseau. Ce rapport présente les données au niveau du mois civil.

Vous pouvez choisir les rapports à proposer à vos comptes connectés. Utilisez l’API Reporting pour récupérer ces rapports pour chaque compte connecté pour chaque mois civil. En savoir plus sur l’exécution d’un rapport depuis l’API.

{
  "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
}

L’exécution des rapports IC+ au niveau du plan et de la transaction peut prendre plusieurs minutes. Si l’état de la réponse de l’appel à l’API ci-dessus est en attente, nous vous recommandons d’ajouter un écouteur d’événements pour l’événement reporting.report_run.succeeded. Après avoir reçu l’événement pour l’exécution du rapport que vous avez créé, assurez-vous de le comparer avec l’ID (par exemple, frr_...) associé à votre exécution du rapport. En savoir plus sur le modèle d’intégration recommandé pour les rapports automatisés.

Le tableau suivant présente les colonnes clés et leurs descriptions pour comprendre les rapports au niveau de l’offre IC+ et des transactions. Ces rapports aident les comptes connectés à suivre leurs coûts de réseau associés.

Nom de colonne	Description
`connected_account_id`	Identifiant du compte connecté. (Par exemple, `acct_1234`)
`connected_account_name`	Nom lisible par l’utilisateur du compte connecté
`network_cost_category`	Catégorie des coûts de réseau. `interchange`, `card_scheme`, `discount` ou ‘non_transactional_card_scheme’
`plan_name`	Nom de l’offre portant sur les coûts de réseau. (Par exemple, `Volume Fee - POS Mastercard Debit/Prepaid`)
`fee_incurred_month`	Début du mois calendaire au cours duquel les frais ont été encourus. Mesuré en secondes depuis l’époque Unix
`variable_rate`	Taux variable applicable à la tarification.
`variable_volume_amount`	Montant total sur la base duquel le `variable_rate` a été appliqué.
`fixed_rate`	Montant des frais fixes applicable à la tarification.
`nombre`	Nombre de fois où le `fixed_rate` a été appliqué.
`fee_amount`	Montant total des frais encourus, qui est égal à `variable_rate` * `variable_volume_amount` + `fixed_rate` * `nombre`
`fee_currency`	Devise des `frais_amount`, `variable_volume_amount` et `fixed_rate`.
`billing_amount`	Montant total facturé au compte connecté.
`billing_currency`	Devise du `billing_amount`
`platform_id`	Identifiant du compte de la plateforme. (Par exemple, `acct_1234`)

Le tableau suivant présente les colonnes clés et leurs descriptions relatives aux transactions de facturation associées au recouvrement des coûts de réseau. Comprendre ces colonnes pour aider à clarifier les interactions financières entre les comptes connectés et la plateforme.

Nom de colonne	Description
`connected_account_id`	Identifiant du compte connecté. (Par exemple, `acct_1234`)
`connected_account_name`	Nom lisible par l’utilisateur du compte connecté
`transfer_id`	Identifiant de l’objet de transfert ou de paiement ayant crédité ou débité les coûts de réseau du solde du compte connecté. (Par exemple, `tr_1234` ou `py_1234`)
`platform_transfer_id`	Identifiant de l’objet de transfert ou de paiement ayant crédité ou débité les coûts de réseau du solde du compte de la plateforme. (Par exemple, `tr_1234` ou `py_1234`)
`transfer_created`	Heure à laquelle le transfert a été créé. Mesurée en secondes depuis l’époque Unix
`balance_transaction_id`	Identifiant de l’opération sur solde qui a effectué la modification du solde du compte connecté (par exemple, `bt_1234`)
`balance_transaction_created`	Heure à laquelle l’opération sur solde a été créée. Mesurée en secondes depuis l’époque Unix
`automatic_payout_id`	ID du virement automatique contenant la balance_transaction
`fee_incurred`	L’heure à laquelle les frais ont été encourus. Mesurée en secondes depuis l’époque Unix
`charge_id`	Identifiant du paiement auquel ces frais sont associés (par exemple, `ch_1234` ou `py_1234`)
`source_transaction_id`	Identifiant du paiement initial auquel ces frais sont associés. Pour les paiements directs, il s’agit de l’identifiant ‘charge_id’. Pour les paiements indirects, il s’agit du paiement sous-jacent imputé au compte de la plateforme. (Par exemple, `ch_1234`)
`refund_id`	Identifiant du remboursement auquel ces frais sont associés
`dispute_id`	Identifiant du litige auquel ces frais sont associés
`captured_amount`	Montant prélevé par la transaction. Non nul uniquement pour les lignes où `fee_category`=`platform_fees`
`captured_currency`	Devise du `captured_amount`
`card_brand`	Marque de la carte bancaire pour laquelle ces frais ont été encourus. (Par exemple, `Visa` ou `MasterCard`)
`bac`	Numéro BIN de la carte bancaire pour laquelle ces frais ont été encourus.
`issuing_bank`	La banque émettrice de la carte pour laquelle ces frais ont été encourus.
`card_funding`	Le type de financement de la carte bancaire pour laquelle ces frais ont été encourus. (Par exemple, `debit`, `credit`, ou `prepaid`)
`card_country`	Le code ISO du pays dans lequel la carte bancaire a été émise. (Par exemple, `US`)
`card_present`	Valeur booléenne indiquant si la carte bancaire était physiquement présente lors de l’achat.
`fee_category`	‘network_cost’ ou `platform_fee`.
`card_scheme_fee`	Montant des frais encourus pour les régimes.
`interchange_or_discount_fee`	Montant des frais d’interchange ou de remise encourus.
`non_transactional_card_scheme_fee`	Montant des frais encourus pour les régimes non transactionnels.
`platform_application_fee`	Commission de la plateforme encourue, devise spécifiée par `billing_currency`.
`fee_currency`	Devise des ‘card_scheme_fee’, `interchange_or_discount_fee` et ‘non_transactional_card_scheme_fee’.
`billing_amount`	Montant total des frais facturés au compte connecté.
`billing_currency`	Devise des colonnes ‘billing_amount’ et `platform_application_fee`.
`platform_id`	Identifiant du compte de la plateforme. (Par exemple, `acct_1234`)

Voici un exemple de ce à quoi peut ressembler l’événement 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"
}

Ensuite, vous pouvez récupérer le rapport pour le compte connecté à l’aide de result_url :

{
  "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
  }

Récupérer le rapport de niveau transaction IC+ d’un compte connecté pour un mois spécifique

Vous pouvez générer le rapport de niveau transaction IC+ d’un compte connecté pour un mois spécifique. En savoir plus sur l’exécution d’un rapport à partir de l’API.

{
  "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
}

Nous vous recommandons d’écouter l’événement reporting.report_run.succeeded.

Ensuite, vous pouvez récupérer le rapport pour le compte connecté à l’aide de result_url :

{
  "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
  }

Analysez les données de coûts réseau avec Sigma et Stripe Data Pipeline

Vous pouvez accéder à ces données de rapport dans Sigma et Stripe Data Pipeline pour réaliser des analyses personnalisées et intégrer les données de coûts réseau dans vos flux de travail existants. Utilisez les tableaux connect_card_payments_fees_plan_level et connect_card_payments_fees_transaction_level. Dans Stripe Data Pipeline, les nouvelles plateformes voient généralement les données sous 72 heures.

Exécutez cette requête pour renvoyer les 10 premières lignes du tableau connect_card_payments_fees_plan_level :

SELECT *
FROM connect_card_payments_fees_plan_level
LIMIT 10