# Configurer un crédit pour vos comptes connectés Découvrez comment configurer les conditions de crédit de vos comptes connectés et financer leurs achats à partir de votre plateforme. ## Fonctionnement des comptes connectés Les comptes connectés sont des comptes Stripe distincts qui appartiennent à vos utilisateurs (marchands, entreprises ou entrepreneurs individuels), mais qui sont gérés par votre plateforme. Considérez-les comme des sous-comptes de votre compte Stripe principal. **Concepts clés :** - **Votre compte de plateforme** : votre compte Stripe principal qui gère tout. - **Comptes connectés** : des comptes individuels pour vos utilisateurs (par exemple, un propriétaire de salle de sport, un restaurateur, un travailleur indépendant). - **Extension de crédit** : vous pouvez étendre le crédit à vos comptes connectés, ce qui leur permet de dépenser de l’argent qu’ils n’ont pas encore et de vous rembourser plus tard **Example de scénarios:** - Vous dirigez une plateforme qui fournit des outils d’entreprise aux propriétaires de salles de sport. - Chaque propriétaire de salle de sport dispose de son propre compte connecté. - Vous pouvez leur accorder une ligne de crédit de 5 000 USD pour acheter du matériel. - Ils dépensent le crédit et vous remboursent à la fin du mois. ## Fonctionnement du crédit avec les comptes connectés Les API Credit permettent de gérer les conditions de crédit de vos comptes connectés. Selon votre politique de crédit avec votre banque partenaire, vous pouvez sélectionner les comptes connectés pouvant bénéficier d’une ligne de crédit, définir la période et le plafond de leur crédit, et les autoriser à effectuer des dépenses et à les rembourser à la fin de leur période de crédit. ## Prérequis 1. [Inscrire votre plateforme](https://dashboard.stripe.com/connect). 1. [Add business details](https://dashboard.stripe.com/account/onboarding). 1. Complétez votre [profil de plateforme](https://dashboard.stripe.com/connect/settings/profile). 1. [Personnalisez les paramètres de marque](https://dashboard.stripe.com/settings/connect/stripe-dashboard/branding). L’ajout du nom de l’entreprise, d’une icône et d’une couleur de marque est obligatoire pour *Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients) Onboarding. 1. La version bêta d’Issuing Credit est activée pour votre compte. Contactez le représentant de votre compte Stripe pour plus d’informations. Consultez le [guide de création de comptes Custom Connect](https://docs.stripe.com/connect/custom-accounts.md) pour procéder à la configuration. ## Demander la fonctionnalité de carte de crédit pour vos comptes connectés Outre la fonctionnalité `transfers` requise pour émettre des cartes, vous devez activer la fonctionnalité `card_issuing_charge_card` pour chaque compte connecté dont vous souhaitez financer les achats à l’aide des fonds disponibles de votre plateforme (et des ressources de votre plateforme, en cas de préfinancement). La fonctionnalité `card_issuing_charge_card` permet à un compte connecté d’émettre des cartes depuis son compte et d’effectuer des paiements dans la limite de son plafond de crédit, tant que votre plateforme Issuing dispose de fonds suffisants pour couvrir ces paiements. Si vous créez un nouveau compte connecté sur votre plateforme, vous pouvez demander la fonctionnalité `card_issuing_charge_card` de la même manière que n’importe quelle autre fonctionnalité. Pour accorder la fonctionnalité `card_issuing_charge_card` à un compte connecté existant, effectuez la demande via un appel de [modification de compte](https://docs.stripe.com/api.md#update_account) à l’API. #### Nouveau compte connecté ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d country=US \ -d type=custom \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "capabilities[card_issuing_charge_card][requested]=true" ``` #### Compte connecté existant ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTED_STRIPE_ACCOUNT_ID}} \ -u "<>:" \ -d "capabilities[card_issuing_charge_card][requested]=true" ``` ## Enregistrer les détails de la demande de l'utilisateur et la limite de crédit approuvée Chaque fois qu’un utilisateur remplit et envoie une demande de crédit à votre plateforme, enregistrez les détails de sa demande et la décision d’approuver ou de refuser avec l’API [Credit Underwriting Record](https://docs.stripe.com/api/issuing/credit_underwriting_record.md). Tout d’abord, utilisez l’endpoint [create_from_application](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_application.md) pour enregistrer l’heure d’envoi de la demande, le [motif de la demande](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_application.md#create_from_application-application-purpose) (`credit_line_opening` pour les nouveaux utilisateurs), ainsi que le nom (`name`) et l’adresse `email` du demandeur dans le hachage [credit_user](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_application.md#create_from_application-credit_user). Vous pouvez spécifier le mode de réception de la demande avec [application_method](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_application.md#create_from_application-application-application_method), mais si vous ne spécifiez pas de valeur, sa valeur par défaut sera `online`. ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/create_from_application \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "credit_user[name]=Barbell Gym" \ --data-urlencode "credit_user[email]=barbell-gym@gmail.com" \ -d "application[purpose]=credit_line_opening" \ -d "application[submitted_at]=1681138952" ``` ### Exemple de réponse ```json { "object": "issuing.credit_underwriting_record", "id": "cur_1NiHAD2eZvKYlo2CmWGpt5OX", "credit_user": { "name": "Barbell Gym", "email": "barbell-gym@gmail.com" }, "created_from": "application", "application": { "purpose": "credit_line_opening", "submitted_at": 1681138952, "application_method": "online" }, "decision_deadline": 1683601352 // 30 days after submission } ``` Pour approuver la demande, utilisez l’endpoint [report_decision](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md) avec l’[ID](https://docs.stripe.com/api/issuing/credit_underwriting_record/object.md#credit_underwriting_record_object-id) de la réponse, définissez le type de décision sur `credit_limit_approved` et spécifiez le montant approuvé. ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/{{CREDITUNDERWRITINGRECORD_ID}}/report_decision \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "decided_at={{DECISIONTIMESTAMP_ID}}" \ -d "decision[type]=credit_limit_approved" \ -d "decision[credit_limit_approved][amount]=100000" \ -d "decision[credit_limit_approved][currency]=usd" ``` Toutes les demandes reçues doivent être enregistrées. Consultez la section [Déclarer d’autres décisions de crédit](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md) pour savoir comment déclarer les demandes rejetées, incomplètes ou retirées par le demandeur. ## Accepter les conditions de la carte de crédit pour activer la fonctionnalité Une fois que vous avez demandé la fonctionnalité `card_issuing_charge_card` pour un compte connecté, activez-la en satisfaisant les [exigences](https://docs.stripe.com/issuing/connect.md#required-verification-information) `card_issuing_charge_card` et en acceptant les [contrats relatifs aux comptes connectés](https://docs.stripe.com/issuing/compliance-us.md), notamment les [Conditions d’utilisation de la carte à débit différé de Cross River Bank](https://stripe.com/legal/issuing/crb-charge-card). ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTED_STRIPE_ACCOUNT_ID}} \ -u "<>:" \ -d "settings[card_issuing_charge_card][cross_river_bank][tos_acceptance][ip]=8.8.8.8" \ -d "settings[card_issuing_charge_card][cross_river_bank][tos_acceptance][date]=1611171056" ``` Ces conditions établissent la relation entre la banque partenaire à l’origine du crédit et le compte connecté. Elles doivent être visibles dans votre flux d’inscription, et vous devez recueillir le consentement explicite de votre utilisateur. Incluez également des Conditions d’utilisation des cartes à débit différé, qui s’appliqueront aux relations entre votre compte connecté et vous. Reprenez les principales Conditions de votre politique de crédit avec le partenaire bancaire, notamment les frais, la période de remboursement, les récompenses et les règles relatives à la définition de la limite de crédit d’un compte connecté. Enregistrez l’acceptation dans l’API seulement quand le compte a accepté les Conditions dans votre flux d’inscription des utilisateurs. ## Déterminer la période de crédit et activer la ligne de crédit *Avant d’entreprendre toute action décrite dans cette section, consultez la politique de crédit de votre partenaire bancaire.* La politique de crédit `CreditPolicy` stocke le plafond de crédit et la période de crédit de votre compte connecté. Lorsque la fonctionnalité `card_issuing_charge_card` devient `active`, Stripe crée une `CreditPolicy` vide et inactive pour le compte connecté, ce qui déclenche l’événement de webhook `issuing_credit_policy.created`. Pour définir l’attribut `credit_limit_amount` vous devez reprendre le montant que vous avez approuvé dans la décision correspondant à la demande, sans quoi la `CreditPolicy` renverra une erreur. Imaginons que Gymbox souhaite octroyer à Barbell (une salle de sport) un crédit dont le plafond est de 1 000 USD, à rembourser le 15 de chaque mois. Gymbox effectue l’appel suivant pour configurer le compte connecté de Barbell : ```curl curl https://api.stripe.com/v1/issuing/credit_policy \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview; issuing_credit_beta=v1; issuing_underwritten_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d credit_limit_amount=100000 \ -d credit_limit_currency=usd \ -d credit_period_interval=month \ -d credit_period_interval_count=1 \ -d "credit_period_ends_on_days[]=15" \ -d days_until_due=0 \ -d status=active ``` Vous pouvez définir la propriété `credit_period_ends_on_days` de façon à ce que le mois se termine le jour de votre choix (du 1er au 28), ou lui assigner la valeur 31 pour que la période se termine le dernier jour du mois, et ce quel que soit le nombre de jours dans le mois. ### Exemple de réponse ```json { "livemode": true, "credit_limit_amount": 100000, "credit_limit_currency": "usd", "status": "active", "credit_period_interval": "month", "credit_period_interval_count": 1, "credit_period_ends_on_days": [15], "days_until_due": 0, "last_effective_attributes": { "effective_until": "time_of_update", "credit_limit_amount": null, "credit_period_interval": null, "credit_period_interval_count": null, "credit_period_ends_on_days": null, "days_until_due": null, "status": "inactive" }, "upcoming_attributes": null } ``` Vous pouvez modifier la `CreditPolicy` en même temps que vous l’activez, comme illustré ci-dessus. Vous pouvez également l’activer séparément, après avoir défini les champs. ```curl curl https://api.stripe.com/v1/issuing/credit_policy \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview; issuing_credit_beta=v1; issuing_underwritten_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d status=active ``` ### Exemple de réponse ```json { "livemode": true, "credit_limit_amount": 100000, "credit_limit_currency": "usd", "status": "active", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "last_effective_attributes": { "effective_until": "time_of_update_to_active", "credit_limit_amount": 100000, "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "status": "inactive" }, "upcoming_attributes": null } ``` Chacune de ces actions déclenche des instances distinctes de l’événement de webhook `issuing_credit_policy.updated`. Une fois la `CreditPolicy` activée, le montant dont votre plateforme dispose est utilisé pour couvrir les dépenses effectuées à l’aide des cartes de vos différents comptes connectés, dans la limite du plafond de crédit défini pour chaque compte. Ces cartes n’utilisent les fonds disponibles de votre plateforme que lorsque le solde Issuing du compte connecté concerné ne permet pas de couvrir une transaction. Si un compte connecté atteint son plafond de crédit et ne dispose plus de fonds sur son solde Issuing, ses autorisations sont automatiquement refusées par Stripe. Stripe crée une `FundingObligation` pour vous aider à gérer et suivre le montant dû par chaque compte à chaque période de crédit. Vous pouvez utiliser une date future comme date d’entrée en vigueur de la période de crédit d’une politique de crédit. Pour cela, utilisez le hachage [upcoming_attributes](https://docs.stripe.com/api/issuing/credit_policy/update.md#update_issuing_credit_policy-upcoming_attributes) et l’horodatage `effective_at`. Consultez la section consacrée à la [gestion des obligations des comptes](https://docs.stripe.com/issuing/credit/manage-account-obligations.md) afin d’en savoir plus sur l’utilisation de `FundingObligation` pour suivre les dépenses et le solde impayé de vos comptes connectés. ## Créer des cartes et des titulaires de cartes Après avoir configuré le crédit de votre compte connecté en activant la [CreditPolicy](https://docs.stripe.com/api/issuing/credit_policy.md), vous pouvez [générer des cartes virtuelles](https://docs.stripe.com/issuing/cards/virtual.md) ou [physiques](https://docs.stripe.com/issuing/cards/physical.md) qu’il pourra utiliser dans la limite de son plafond de crédit.