Configurer un crédit pour vos comptes connectésVersion bêta privée

Outre les fonctionnalités card_issuing et transfers requises pour l’émission de cartes, vous devez activer la fonctionnalité funding_credit pour les programmes de cartes à débit différé. La fonctionnalité funding_credit permet à un compte connecté d’effectuer des paiements dans la limite de son plafond de crédit, tant que votre compte de plateforme Issuing dispose de fonds suffisants pour couvrir ces paiements. Si vous créez un nouveau compte connecté sur votre plateforme, vous pouvez ajouter la fonctionnalité funding_credit de la même manière que pour les autres fonctionnalités. Si vous accordez un crédit à un compte connecté existant de votre plateforme, vous pouvez demander la fonctionnalité funding_credit via un appel à l’API de modification de compte.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d country=US \
  -d type=custom \
  -d "capabilities[transfers][requested]"=true \
  -d "capabilities[card_issuing][requested]"=true \
  -d "capabilities[funding_credit][requested]"=true

La fonctionnalité funding_credit peut être activée sur demande. Stripe crée alors une CreditPolicy vide et inactive pour le compte, ce qui déclenche l’événement de webhook issuing_credit_policy.created.

La politique de crédit CreditPolicy définit le plafond de crédit et la période de crédit de votre compte connecté.

Imaginons que Gymbox souhaite octroyer à Barbell (une salle de sport) une limite de crédit de 1 000 USD, à rembourser le 15 de chaque mois. Gymbox effectue l’appel suivant pour configurer le compte connecté de Barbell :

curl https://api.stripe.com/v1/issuing/credit_policy \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -H "Stripe-Version: 2025-09-30.clover; issuing_credit_beta=v1" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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

{
"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": nil,
  "credit_period_interval": nil,
  "credit_period_interval_count": nil,
  "credit_period_ends_on_days": nil,
  "days_until_due": nil,
  "status": "active",
},
"upcoming_attributes": nil
}

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 https://api.stripe.com/v1/issuing/credit_policy \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -H "Stripe-Version: 2025-09-30.clover; issuing_credit_beta=v1" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d status=active

Exemple de réponse

{
  "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": nil
}

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 et l’horodatage effective_at.

Consultez la section consacrée à la gestion des obligations des comptes afin d’en savoir plus sur l’utilisation de FundingObligation pour suivre les dépenses et le solde impayé de vos comptes connectés.