# Gérer les conditions de crédit Découvrez comment gérer les conditions de crédit de vos comptes connectés. Modifiez les conditions de crédit d’un compte connecté en modifiant l’attribut [credit_limit_amount](https://docs.stripe.com/api/issuing/credit_policy/object.md#issuing_credit_policy_object-credit_limit_amount) ou [credit_period_interval](https://docs.stripe.com/api/issuing/credit_policy/object.md#issuing_credit_policy_object-credit_period_interval) de sa politique de crédit. Vous pouvez également désactiver la possibilité pour un compte connecté de réaliser des dépenses financées par le compte Issuing de votre plateforme en configurant l’état sur `inactive`. ## Modifier le plafond de crédit Vous pouvez modifier le plafond de crédit d’un compte connecté en mettant à jour l’attribut `credit_limit_amount` de la politique de crédit, mais vous devez d’abord déclarer la décision d’évaluation des risques dans CreditUnderwritingRecord. Si vous tentez de modifier `credit_limit_amount` sans entrer d’abord le même montant via CreditUnderwritingRecord, vous recevrez un message d’erreur. Trois scénarios permettent de déclarer des décisions d’évaluation des risques afin de modifier un plafond de crédit via l’API CreditUnderwritingRecord : #### Approuver l'augmentation du plafond de crédit ## Approuver la demande d’augmentation du plafond de crédit d’un compte Si un compte connecté demande une limite de crédit plus élevée, enregistrez d’abord sa demande, puis enregistrez l’approbation ou le refus de la demande. Enregistrez la demande du compte via l’endpoint [create_from_application](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_application.md) de l’API CreditUnderwritingRecord. Définissez le paramètre [purpose](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_application.md#create_from_application-application-purpose) (motif) de la demande sur `credit_limit_increase` et utilisez l’attribut `submitted_at` pour indiquer la date et l’heure de la demande du client. Bien s’il s’agisse d’un utilisateur existant, vous devez spécifier les champs `name` et `email` dans le hachage `credit_user`. ```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_limit_increase" \ -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_limit_increase", "submitted_at": 1681138952, "application_method": "online" }, "decision_deadline": 1683601352 // 30 days after submission } ``` La deuxième étape consiste à approuver ou à refuser la demande à l’aide de l’endpoint [report_decision](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md). Veillez à communiquer la décision avant la date de [decision_deadline](https://docs.stripe.com/api/issuing/credit_underwriting_record/object.md#credit_underwriting_record_object-decision_deadline), soit 30 jours après l’envoi de la demande par le client. Pour approuver la demande, définissez le [type de décision](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md#report_decision-decision-type) sur `credit_limit_approved` et indiquez 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]=200000" \ -d "decision[credit_limit_approved][currency]=usd" ``` Pour refuser une demande, suivez les étapes ci-dessus, mais définissez le type de décision sur `application_rejected` et indiquez les motifs du rejet dans l’attribut [application_rejected.reasons](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md#report_decision-decision-application_rejected-reasons). Pour en savoir plus sur ce scénario, consultez la section dédiée au [rejet d’une demande d’augmentation du plafond de crédit et à la communication du motif du rejet](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#reject-application). #### Augmenter le plafond de crédit de manière proactive ## Augmenter un plafond de crédit de manière proactive, sans demande du client Pour augmenter le plafond de crédit d’un compte connecté en l’absence de demande du client, communiquez la décision en une étape via l’endpoint [create_from_proactive_review](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md) de l’API CreditUnderwritingRecord. (Pour en savoir plus, consultez la section dédiée aux [décisions d’évaluation de crédit proactive](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#make-proactive-decisions)). Définissez le [type de décision](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md#create_from_proactive_review-decision-type) sur `credit_limit_approved` et indiquez le nouveau montant dans le paramètre [credit_limit_approved.amount](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md#report_decision-decision-credit_limit_approved-amount). ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/create_from_proactive_review \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "credit_user[name]=Barbell Gym" \ --data-urlencode "credit_user[email]=barbell-gym@gmail.com" \ -d "decided_at={{DECISIONTIMESTAMP_ID}}" \ -d "decision[type]=credit_limit_approved" \ -d "decision[credit_limit_approved][amount]=2000000" \ -d "decision[credit_limit_approved][currency]=usd" ``` ### 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": "proactive_review", "decided_at": 1681138965, "decision": { "type": "credit_limit_approved", "credit_limit_approved": { "amount": 2000000, "currency": "usd" } }, "decision_deadline": null // no deadline for proactive review } ``` #### Réduire le plafond de crédit de manière proactive ## Diminuer un plafond de crédit et en indiquer le motif Pour réduire le plafond de crédit d’un compte connecté, communiquez la décision de votre plateforme en une étape via l’endpoint [create_from_proactive_review](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md) de l’API CreditUnderwritingRecord. (Pour en savoir plus, consultez la section dédiée aux [décisions d’évaluation de crédit proactive](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#make-proactive-decisions)). Définissez le [type de décision](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md#create_from_proactive_review-decision-type) sur `credit_limit_decreased`, et indiquez le nouveau montant dans [credit_limit_approved.amount](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md#report_decision-decision-credit_limit_approved-amount). La réduction d’un plafond de crédit étant une décision défavorable, vous devez également indiquer au moins une `reason` de cette diminution (et jusqu’à quatre), à partir de la liste des raisons figurant dans [credit_limit_decreased.reasons](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md#create_from_proactive_review-decision-credit_limit_decreased-reasons). Il doit s’agir des raisons « principales » du rejet de la demande et elles doivent être cohérentes avec les raisons de rejet définies dans votre politique de crédit approuvée par la banque. Les avis de décision défavorable doivent inclure toutes les raisons que vous avez fournies (consulter la rubrique[ Envoi d’e-mails d’avis de décision défavorable](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#sending-adverse-action-notice-emails)). ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/create_from_proactive_review \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "credit_user[name]=Barbell Gym" \ --data-urlencode "credit_user[email]=barbell-gym@gmail.com" \ -d "decided_at={{DECISIONTIMESTAMP_ID}}" \ -d "decision[type]=credit_limit_decreased" \ -d "decision[credit_limit_decreased][reasons][]=debt_to_cash_balance_ratio_too_high" \ -d "decision[credit_limit_decreased][reasons][]=runway_too_short" \ -d "decision[credit_limit_decreased][amount]=500000" \ -d "decision[credit_limit_decreased][currency]=usd" ``` ### 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": "proactive_review", "decided_at": 1681138965, "decision": { "type": "credit_limit_decreased", "credit_limit_decreased": { "reasons": ["debt_to_cash_balance_ratio_too_high", "runway_too_short"], "amount": 500000, "currency": "usd" } }, "decision_deadline": null // no deadline for proactive review } ``` > Faites preuve de prudence lorsque vous diminuez l’attribut `credit_limit_amount` d’un compte, car cela peut entraîner des refus d’autorisation immédiats si le compte a déjà dépensé plus que le nouveau montant de `credit_limit_amount`. Dans chaque scénario, après avoir signalé la décision, modifiez l’attribut `credit_limit_amount` avec l’API CreditPolicy de façon à refléter le montant que vous avez approuvé. ```curl curl https://api.stripe.com/v1/issuing/credit_policy \ -u "<>:" \ -H "Stripe-Version: 2026-04-22.preview; issuing_credit_beta=v1; issuing_underwritten_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d credit_limit_amount=200000 ``` Cette action déclenche un événement de webhook `issuing_credit_policy.updated` et met immédiatement à jour le champ `credit_limit_amount` de la `CreditPolicy`. ### Exemple de réponse ```json { "livemode": true,"credit_limit_amount": 200000, // 2,000.00 USD "credit_limit_currency": "usd", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "last_effective_attributes": { "effective_until": 1681138965, "credit_limit_amount": 100000, "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "status": "active" }, "upcoming_attributes": null } ``` ## Modifier la durée du crédit La période de crédit que vous définissez doit toujours correspondre à celle définie dans le document de politique de crédit approuvé par la banque. Avant de pouvoir modifier une période de crédit via l’API, Stripe doit d’abord approuver la modification de la période de crédit dans votre politique de crédit écrite. Vous devrez peut-être également envoyer un avis de modification des conditions aux titulaires de comptes concernés. Avant d’entreprendre toute action, veuillez nous contacter à l’adresse [platform-compliance@stripe.com](mailto:platform-compliance@stripe.com) pour obtenir les approbations requises. Après avoir reçu l’approbation de Stripe, suivez les étapes ci-dessous pour modifier une période de crédit dans l’API CreditPolicy. Vous n’avez pas besoin d’utiliser l’API CreditUnderwritingRecord lorsque vous modifiez une période de crédit. Vous pouvez modifier la période de crédit d’un compte connecté en modifiant les champs dans le hachage [upcoming_attributes](https://docs.stripe.com/api/issuing/credit_policy/update.md#update_issuing_credit_policy-upcoming_attributes). Pour planifier la date à laquelle vous souhaitez que les modifications prennent effet, vous devez transmettre un horodatage `effective_at` lorsque vous définissez les `upcoming_attributes`. Reprenons notre exemple précédent et supposons que Gymbox, une plateforme, décide de faire passer son client d’une période de crédit mensuelle à une période de 15 jours, et que la plateforme souhaite que ce changement prenne effet au début du mois suivant. L’horodatage `effective_at` doit comporter 10 chiffres et se terminer par 00, car Stripe exige que toutes les modifications effectuées via `upcoming_attributes` prennent effet à 00:00 UTC. La plateforme modifie la `CreditPolicy` du compte connecté comme suit, à l’aide du hachage `upcoming_attributes` : ```curl curl https://api.stripe.com/v1/issuing/credit_policy \ -u "<>:" \ -H "Stripe-Version: 2026-04-22.preview; issuing_credit_beta=v1; issuing_underwritten_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "upcoming_attributes[credit_period_interval]=day" \ -d "upcoming_attributes[credit_period_interval_count]=15" \ -d "upcoming_attributes[effective_at]={{EFFECTIVEATTIMESTAMP_ID}}" \ -d "upcoming_attributes[days_until_due]=0" ``` ### Exemple de réponse ```json { "livemode": true, "credit_limit_amount": 200000, "credit_limit_currency": "usd", "status": "active", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "last_effective_attributes": { "effective_until": 1681138965, // time of previous update to credit period "credit_limit_amount": 200000, "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "status": "active" }, "upcoming_attributes": {"effective_at": 1693526400, // 1st day of the next month, 00:00 UTC "credit_period_interval": "day", "credit_period_interval_count": 15, "days_until_due": 0, } } ``` À l’horodatage `effective_at`, la politique de crédit `CreditPolicy` sera automatiquement modifiée pour refléter le hachage `upcoming_attributes`, et le hachage `last_effective_attributes` sera modifié pour refléter les valeurs avant modification. ### Exemple de réponse ```json { "livemode": true, "credit_limit_amount": 200000, "credit_limit_currency": "usd", "status": "active","credit_period_interval": "day", "credit_period_interval_count": 15, "days_until_due": 0, "last_effective_attributes": { "effective_until": 1693526400, // 1st day of the next month, 00:00 UTC "credit_limit_amount": 200000, "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "status": "active" }, "upcoming_attributes": null } ``` Cela déclenche un événement `issuing_credit_policy.updated`. Lorsque la modification de la période de crédit prend effet selon l’horodatage `effective_at`, la [FundingObligation](https://docs.stripe.com/api/issuing/funding_obligations.md) est finalisée pour la période en cours, et une nouvelle `FundingObligation` marquant le début d’un nouveau crédit est créée avec de nouvelles conditions. ## Clôturer la ligne de crédit et en indiquer le motif Vous pouvez clôturer la ligne de crédit du compte connecté en suivant ces deux étapes. Tout d’abord, utilisez l’API CreditUnderwritingRecord pour soumettre les détails de la décision via l’endpoint [create_from_proactive_review](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md). Définissez le type de décision sur `credit_line_closed` et fournissez au moins une raison, vous pouvez en fournir jusqu’à quatre. Il doit s’agir des raisons « principales » du rejet de l’inscription et elles doivent être cohérentes avec les motifs de rejet définis dans votre politique de crédit approuvée par la banque. [La fermeture d’une ligne de crédit est un avis de décision défavorable](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#credit-line-closed), il est donc nécessaire d’envoyer un avis avec les raisons applicables de la fermeture. [Consultez la liste complète des motifs de décision valables](https://docs.stripe.com/api/issuing/credit_underwriting_record/object.md#credit_underwriting_record_object-decision-credit_line_closed-reasons) pour les décisions `credit_line_closed`. ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/create_from_proactive_review \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "credit_user[name]=Barbell Gym" \ --data-urlencode "credit_user[email]=barbell-gym@gmail.com" \ -d "decided_at={{DECISIONTIMESTAMP_ID}}" \ -d "decision[type]=credit_line_closed" \ -d "decision[credit_line_closed][reasons][]=incomplete_application" ``` ### 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": "proactive_review", "decided_at": identifier("decisionTimestamp"), "decision": { "type": "credit_line_closed", "credit_line_closed": { "reasons": ["incomplete_application"] } }, "decision_deadline": null // no deadline for proactive review } ``` Ensuite, définissez l’[état](https://docs.stripe.com/api/issuing/credit_policy/update.md#update_issuing_credit_policy-status) de la politique de crédit du compte sur `inactive`. ```curl curl https://api.stripe.com/v1/issuing/credit_policy \ -u "<>:" \ -H "Stripe-Version: 2026-04-22.preview; issuing_credit_beta=v1; issuing_underwritten_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d status=inactive ``` ### Exemple de réponse ```json { "livemode": true, "credit_limit_amount": 200000, "credit_limit_currency": "usd","status": "inactive", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "last_effective_attributes": { "effective_until": "time_of_deactivation", "credit_limit_amount": 200000, "status": "active", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1 }, "upcoming_attributes": null } ``` Ce changement d’état déclenche un événement `issuing_credit_policy.updated`. Lorsque vous désactivez une `CreditPolicy`, vous continuez à recevoir les mises à jour de la `FundingObligation` au cours des 31 jours suivants pour tenir compte de toutes les [transactions](https://docs.stripe.com/api/issuing/transactions/object.md) effectuées, car les autorisations obtenues avant la désactivation peuvent être capturées jusqu’à 31 jours plus tard. Si le [solde Issuing](https://docs.stripe.com/issuing/connect/funding.md) du compte connecté est inférieur à 0 (ce qui signifie que le compte doit de l’argent à Stripe) quand vous tentez de faire passer la politique de crédit à l’état `inactive`, vous recevez un message d’erreur. Pour ramener le solde à zéro et désactiver la CreditPolicy, vous devez recharger le solde. Une fois l’objet CreditPolicy à l’état `inactive`, les tentatives d’autorisation sur les cartes du compte sont financées par le [solde Issuing](https://docs.stripe.com/issuing/connect/funding.md) du compte et feront l’objet d’un refus en cas de solde insuffisant. Une fois que vous avez clôturé la ligne de crédit en la faisant passer à l’état `inactive`, vous ne pourrez plus la rouvrir en la faisant à nouveau passer à l’état `active`, sauf si vous recevez une nouvelle demande du client. Dans ce cas, suivez les étapes de [signalement d’une nouvelle demande de crédit approuvée](https://docs.stripe.com/issuing/credit/connect-credit-setup.md#record-application-details). ## Révoquer la fonctionnalité card_issuing_charge_card Si vous avez cessé d’utiliser votre compte de plateforme Issuing pour prendre en charge un compte connecté parce qu’il ne répond plus aux critères d’évaluation des risques de votre politique de crédit approuvée par la banque ou qu’il enfreint les Conditions d’utilisation du service, laissez sa `CreditPolicy` inactive. Vous devez également révoquer sa fonctionnalité `card_issuing_charge_card` en l’annulant. ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTED_STRIPE_ACCOUNT_ID}} \ -u "<>:" \ -d "capabilities[card_issuing_charge_card][requested]=false" ``` Vous pourrez par la suite demander la fonctionnalité `card_issuing_charge_card` pour le même compte connecté si l’utilisateur envoie une nouvelle demande en suivant les étapes de [configuration du crédit d’un compte connecté](https://docs.stripe.com/issuing/credit/connect-credit-setup.md#activate-funding-credit). Vous pouvez continuer à émettre des cartes pour un compte connecté dont la fonctionnalité `card_issuing` est active. Mais pour que celles-ci soient utilisables, vous devrez ajouter des fonds au [solde Issuing](https://docs.stripe.com/issuing/connect/funding.md) du compte connecté concerné. ## Récapitulatif des webhooks Pour rappel, vous pouvez surveiller ces deux webhooks : - `issuing_credit_policy.created` : se déclenche à la création d’une `CreditPolicy`, ce qui se produit lorsque la fonctionnalité est demandée pour le compte connecté. - `issuing_credit_policy.updated` : se déclenche à chaque modification d’une `CreditPolicy`, ce qui peut se produire lorsque la plateforme met à jour la politique du compte connecté.