Gérer les conditions de créditVersion bêta privée
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 ou 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_ 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_ 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 :
Dans chaque scénario, après avoir signalé la décision, modifiez l’attribut credit_ avec l’API CreditPolicy de façon à refléter le montant que vous avez approuvé.
Cette action déclenche un événement de webhook issuing_ et met immédiatement à jour le champ credit_ de la CreditPolicy.
Exemple de réponse
{ "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 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. Pour planifier la date à laquelle vous souhaitez que les modifications prennent effet, vous devez transmettre un horodatage effective_ lorsque vous définissez les upcoming_.
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_ doit comporter 10 chiffres et se terminer par 00, car Stripe exige que toutes les modifications effectuées via upcoming_ prennent effet à 00:00 UTC.
La plateforme modifie la CreditPolicy du compte connecté comme suit, à l’aide du hachage upcoming_ :
Exemple de réponse
{ "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_, la politique de crédit CreditPolicy sera automatiquement modifiée pour refléter le hachage upcoming_, et le hachage last_ sera modifié pour refléter les valeurs avant modification.
Exemple de réponse
{ "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_. Lorsque la modification de la période de crédit prend effet selon l’horodatage effective_, la FundingObligation 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 envoyer les détails de la décision via l’endpoint create_from_proactive_review. Définissez le type de décision sur credit_ et indiquez de un à quatre motifs. Il doit s’agir des « principaux » motifs de refus de la demande. Ils doivent correspondre aux motifs de refus définis dans votre politique de crédit approuvée par la banque. La clôture d’une ligne de crédit constituant une action défavorable, vous devez obligatoirement envoyer un avis précisant les motifs applicables de la clôture.
Exemple de réponse
{ "object": "issuing.credit_underwriting_record", "id": "cur_1NiHAD2eZvKYlo2CmWGpt5OX", "credit_user": { "name": "Barbell Gym", "email": "barbell-gym@gmail.com" }, "created_from": "proactive_review", "decided_at": 1681138952, "decision": { "type": "credit_line_closed", "credit_line_closed": { "reasons": ["debt_to_cash_ratio_too_high"] } }, "decision_deadline": null // no deadline for proactive review }
Ensuite, définissez l’état de la politique de crédit du compte sur inactive.
Exemple de réponse
{ "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_. 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 effectuées, car les autorisations obtenues avant la désactivation peuvent être capturées jusqu’à 31 jours plus tard.
Si le solde Issuing 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 une 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 du compte et feront l’objet d’un refus en cas de solde insuffisant.
Once you’ve closed the credit line by setting status to inactive, you can’t reopen the line by changing status back to active unless you receive a new application from the customer. In that case, follow the steps to report a new, approved credit application.
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_ en l’annulant.
Vous pourrez par la suite demander la fonctionnalité 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é.
Vous pouvez continuer à émettre des cartes pour un compte connecté dont la fonctionnalité card_ est active. Mais pour que celles-ci soient utilisables, vous devrez ajouter des fonds au solde Issuing du compte connecté concerné.
Récapitulatif des webhooks
Pour rappel, vous pouvez surveiller ces deux webhooks :
issuing_: se déclenche à la création d’unecredit_ policy. created CreditPolicy, ce qui se produit lorsque la fonctionnalité est demandée pour le compte connecté.issuing_: se déclenche à chaque modification d’unecredit_ policy. updated CreditPolicy, ce qui peut se produire lorsque la plateforme met à jour la politique du compte connecté.