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 vos conditions de crédit en mettant à jour le plafond credit_limit_amount ou la période de crédit credit_period_interval d’un compte connecté. Vous pouvez également désactiver la possibilité pour un compte connecté de réaliser des dépenses à crédit financées par le compte Issuing de votre plateforme.

Modifier le plafond de crédit

Vous pouvez à tout moment augmenter ou diminuer le plafond de crédit d’un compte connecté en modifiant le paramètre credit_limit_amount de sa CreditPolicy. L’exemple suivant fait passer le plafond de crédit du compte connecté de 1 000 USD à 2 000 USD :

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": time_of_update_to_credit_limit,
    "credit_limit_amount": 100000,
    "credit_period_interval": "month",
    "credit_period_interval_count": 1,
    "days_until_due": 1,
    "status": "active",
  },
  "upcoming_attributes": nil
}

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.

Faites preuve de prudence lorsque vous diminuez le plafond de crédit credit_limit_amount d’un compte, car cela peut entraîner des refus d’autorisation instantanés si le compte a déjà dépensé plus que le nouveau montant credit_limit_amount.

Modifier la durée du crédit

Vous pouvez modifier la période de crédit d’un compte connecté en modifiant les champs du hachage upcoming_attributes. Pour définir la date à laquelle les modifications doivent prendre effet, vous devez transmettre un horodatage effective_at lors de la définition des upcoming_attributes. Nous vous recommandons d’informer le compte connecté des modifications apportées à la période de son crédit (votre Politique de recouvrement et de service peut l’exiger).

Reprenons notre exemple précédent et supposons que Gymbox décide de faire passer Barbell d’une période de crédit mensuelle à une période de crédit de 15 jours. Supposons que Gymbox souhaite que cette modification prenne effet au début du mois suivant. Gymbox met à jour la CreditPolicy du compte connecté comme suit, en utilisant le hachage upcoming_attributes :

L’heure d’activation de la politique de crédit doit être réglée sur 00:00 UTC.

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": 11223344, // time of update to credit period
    "credit_limit_amount": 100000,
    "credit_period_interval": "month",
    "credit_period_interval_count": 1,
    "days_until_due": 1,
    "status": "active",
  },
  "upcoming_attributes": {
    "effective_at": 12345678, // 1st day of the next month, 00:00 UTC
    "credit_period_interval": "day",
    "credit_period_interval_count": 15,
    "days_until_due": 0,
    "status": "active",
  }
}

À l’horodatage effective_at, la politique de crédit CreditPolicy sera automatiquement mise à jour en fonction du hachage upcoming_attributes :

{
  "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": 12345678, // 1st day of the next month, 00:00 UTC
    "credit_limit_amount": 200000,
    "status": "active",
    "credit_period_interval": "month",
    "credit_period_interval_count": 1,
    "days_until_due": 1,
  },
  "upcoming_attributes": nil
}

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 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.

Désactiver la politique de crédit

Vous pouvez temporairement cesser de financer les dépenses d’un compte connecté à l’aide de votre plateforme Issuing en désactivant sa politique de crédit CreditPolicy. Pour cela, le solde du compte connecté doit être supérieur ou égal à 0. Si vous désactivez une CreditPolicy alors que les fonds du compte connecté sont insuffisants, Stripe refusera ses autorisations de carte. Vous pouvez réactiver la CreditPolicy à tout moment.

Exemple de réponse

{
  "livemode": true,
  "credit_limit_amount": 200000,
  "credit_limit_currency": "usd",
  "status": "inactive",
  "credit_period_interval": "day",
  "credit_period_interval_count": 15,
  "days_until_due": 0,
  "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": nil
}

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 effectuées, car les autorisations obtenues avant la désactivation peuvent être capturées jusqu’à 31 jours plus tard.

Révoquer la fonctionnalité funding_credit

Pour cesser totalement de financer les dépenses d’un compte connecté via votre plateforme Issuing, révoquez sa fonctionnalité funding_credit. Pour cela, le solde du compte connecté doit être supérieur ou égal à 0.

Vous devez désactiver la CreditPolicy du compte avant d’annuler sa fonctionnalité funding_credit. Par la suite, vous pourrez à nouveau demander la fonctionnalité funding_credit pour ce compte. Dans ce cas, le compte connecté en question n’aura pas besoin d’accepter à nouveau les conditions.

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 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é.