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_
, 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_
à 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_
et 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 } }
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_
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_
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_
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.
. 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 |
---|---|
platform_ | L’ID de la plateforme qui facilite le débité. |
connected_ | L’ID du compte connecté pour lequel le débité a été traité, et celui qui a finalement payé les frais de réseau. |
connected_ | Le nom du connecté pour lequel le débité a été traité, et celui qui a finalement payé les coûts de réseau. |
plan_ | Le nom du plan d’interchange. Tous les plans du réseau sont regroupés en une seule ligne appelée frais du réseau. |
variable_ | Taux variable facturé par les réseaux pour les plans spécifiques. |
variable_ | Volume évalué pour les coûts de réseau des plans spécifiques. |
fixed_ | Les frais fixes associés au volume évalué pour les plans spécifiques. |
nombre | Nombre de paiements évalués pour les coûts de réseau du plan spécifique. |
fee_ | Le montant total des coûts de réseau facturés. |
fee_ | La devise des frais de réseau facturés. |
network_ | Catégorie du coût de réseau facturé. card_ ou interchange_ . |
billing_ | Le montant total de ces frais déduit de votre solde Stripe, taxes comprises et après conversion de devises. Exprimé en unités majeures de billing_currency. |
billing_ | Le code ISO à trois lettres correspondant à la devise dans laquelle votre solde Stripe est débité pour ces frais. |
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_ | L’ID du compte connecté pour lequel le débité a été traité, et le compte qui a finalement payé les frais de réseau. |
connected_ | L’ID du compte connecté pour lequel le débité a été traité, et le compte qui a finalement payé les frais de réseau. |
balance_ | L’identifiant unique de l’opération sur solde pour les frais de réseau récupérés par la plateforme. |
balance_ | Horodatage de la création de l’opération sur solde pour le coût de réseau récupéré par la plateforme. |
automatic_ | L’ID du virement créé automatiquement associé à cette opération sur solde (défini uniquement si votre compte est soumis à une fréquence de virement automatique). |
fee_ | L’heure (en UTC) de l’événement ayant entraîné ces frais. |
charge_ | L’ID unique du débité présenté au compte connecté. Pour les débités qui se règlent sur le compte connecté, ce champ contient la valeur de l’ID du débit. Pour les débités qui se règlent sur la plateforme et sont ensuite transférés sur le compte connecté, ce champ contient la valeur du transfert. |
source_ | L’ID unique du débité associé, le cas échéant. Pour débiter, il s’agit du débité lui-même ; pour les remboursements ou les litiges, il s’agit du débit initial en cours de remboursement ou de contestation. |
captured_ | Le montant capturé sur le débité. |
captured_ | Devise du montant capturé. |
refund_ | ID unique du remboursement associé, le cas échéant. |
dispute_ | ID unique du litige associé (le cas échéant). |
card_ | La marque de la carte, le cas échéant. |
bac | Le numéro d’identification bancaire (BIN) associé à la carte utilisée dans la transaction. Le BIN est associé à la banque qui a émis la carte. Vous pouvez utiliser les BIN pour rechercher des informations sur la banque émettrice et sur la carte elle-même. |
transfer_ | L’ID de l’objet de transfert qui capture le recouvrement des coûts de réseau entre le compte connecté et la plateforme. |
platform_ | L’ID de l’objet de transfert pour que la plateforme reçoive les coûts de réseau du compte connecté. Ceci est uniquement pertinent pour les plateformes. |
transfer_ | Horodatage du transfert entre le compte connecté et la plateforme pour le recouvrement des coûts de réseau. |
issuing_ | Le nom de la banque qui a émis la carte, qui est généralement (mais pas toujours) disponible pour Stripe. |
card_ | Le type de financement par carte, le cas échéant. |
card_ | Code ISO à deux lettres du pays dans lequel la carte a été émise. |
card_ | Si la valeur est vraie , cela indique qu ’ un débité associé à ces frais a été initié par lecture d ’ une bande magnétique ou d ’ une puce EMV. |
fee_ | Soit platform_ (qui désigne les commissions de plateforme facturées par la plateforme), soit network_ (qui désigne les frais fixés par un réseau de paiement). |
card_ | Les frais du réseau transactionnel associés au débité particulier. |
interchange_ | Les frais d’interchange ou de réduction associés au débité. |
non_ | Les frais de réseau de cartes non transactionnels associés au débité. |
platform_ | Les commissions de la plateforme débitées pour ce paiement. |
billing_ | Le montant total de ces frais, exprimé en unités majeures de billing_ , est déduit de votre solde Stripe, taxes comprises et après conversion de devises. |
billing_ | Le code ISO à trois lettres correspondant à la devise dans laquelle votre solde Stripe est débité pour ces frais. |
Voici un exemple de ce à quoi peut ressembler l’événement reporting.
:
{ "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_
:
{ "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.
.
Ensuite, vous pouvez récupérer le rapport pour le compte connecté à l’aide de result_
:
{ "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 }