Post-financez votre intégration avec les réserves dynamiquesVersion bêta privée

Découvrez comment utiliser les réserves dynamiques pour le post-financement des achats effectués par carte.

Mise en garde

Cette API est actuellement en version bêta. Les noms de champs ou les concepts généraux sont susceptibles d’être modifiés dans des versions ultérieures. Pour accéder aux API Dynamic Reserves, transmettez l’en-tête suivant dans toutes les requêtes API : Stripe-Version: <your stripe version>;issuing_credit_beta=v2;

Les réserves dynamiques permettent aux plateformes d’ajuster leurs propres limites de crédit en temps réel pour gérer la trésorerie entre Stripe et les fonds disponibles pour l’autorisation. Cette fonctionnalité vous permet de :

Contrôlez l’utilisation du capital et minimisez les coûts de financement
Limites de contrôle qui déterminent la disponibilité des autorisations
Utilisez Stripe pour gérer la volatilité inattendue Vos comptes connectés peuvent accumuler un solde Issuing négatif sur les dépenses par carte et post-financer Stripe plus tard. Vous pouvez approvisionner votre solde Issuing une fois que le réseau a capturé les autorisations (généralement 1 jour après la création de l’autorisation) au lieu de préfinancer votre solde Issuing avant toute dépense par carte. Chaque jour, Stripe vous informe du montant que vous devez, et vous pouvez envoyer un virement le jour même pour financer Stripe avant la date limite. Vous devez approvisionner Stripe avant la date limite (généralement 20h00 UTC) pour éviter des frais de retard et des pénalités supplémentaires.

Connect

Si vous post-financez une plateforme Connect, le comportement de votre compte connecté est le même que celui décrit dans :

La relation entre votre plateforme et vos comptes connectés ne change pas. La principale différence réside dans le fait qu’au lieu d’avoir à préfinancer les dépenses globales de vos comptes connectés, vous pouvez les post-financer.

Avant de commencer

Établissez une réserve, accessible uniquement en cas de défaillance opérationnelle.
Envoyez des virements à partir de votre banque.

Configuration du programme de cartes

Stripe configure une CreditPolicy pour votre plateforme ou votre programme de carte direct, qui contient des informations sur vos obligations de paiement et les conditions applicables. Votre programme de carte CreditPolicy diffère de la CreditPolicy que vous avez définie sur vos comptes connectés. Stripe définit et contrôle votre programme de carte CreditPolicy, qui définit les champs suivants :

current_exposure_limit_amount : montant total maximal pouvant être dépensé sur l’ensemble de vos comptes connectés (ou compte, dans le cas d’un utilisateur direct). Nous calculons le current_exposure_limit_amount en combinant les valeurs funded_reserve_amount et reserve_multiplier selon l’équation suivante : current_exposure_limit_amount = MIN [(funded_reserve_amount * reserve_multiplier), maximum_exposure_limit]
reserve_multiplier_decimal : le montant par lequel le funded_reserve_amount est multiplié pour déterminer le current_exposure_limit_amount. Le reserve_multiplier_decimal est déterminé au début du programme de post-financement.
max_exposure_limit_amount : montant total maximal pouvant être dépensé sur l’ensemble de vos comptes connectés (ou compte, dans le cas d’un utilisateur direct). Votre limite d’exposition maximale est égale à une valeur fixe, définie par Stripe, plus votre funded_reserve_amount.
funded_reserve_amount : correspond au total des réserves que vous avez comptabilisées auprès de Stripe.
exposure_limit_currency : le code monétaire à trois lettres du current_exposure_limit_amount et du max_exposure_limit_amount.

Stripe facture des frais si vos dépenses sont supérieures à votre funded_reserve, si vous dépassez votre current_exposure_limit ou si vous êtes en retard dans le paiement d’une funding_obligation. Bien que Stripe vous permette de dépenser au-delà de votre current_exposure_limit jusqu’à votre max_exposure_limit, il s’agit d’un capital d’urgence plutôt que d’un financement que vous utilisez.

Par exemple, si vous avez un funded_reserve_amount de 1 000 USD, un reserve_multiplier_decimal de 2,0x, un current_exposure_limit_amount de 2 000 USD et un max_exposure_limit_amount de 3 000 USD :

Stripe vous facture des frais d’« utilisation de crédit » pour toute dépense comprise entre 1 000 USD et 2 000 USD.
Stripe facture des frais de « capital d’urgence » plus élevés pour les dépenses comprises entre 2 000 USD et 3 000 USD.
Stripe refuse les transactions supérieures à 3 000 USD.

Pour récupérer les détails de votre programme de carte CreditPolicy, appelez l’endpoint API GET CreditPolicy :

Command Line
curl https://api.stripe.com/v1/issuing/credit_policy -u "sk_***:" -H "Stripe-Version: 2024-06-20; issuing_credit_beta=v2"

Consultez l’exemple de réponse suivant :

{
  "livemode": true,
  "current_exposure_limit_amount": 11359999920 ,
   "reserve_multiplier_decimal": "2.4",
   "max_exposure_limit_amount": 13133333300,
   "funded_reserve_amount": 4733333300,
    // other fields
}

Stripe applique toute modification apportée à la CreditPolicy au bout de T+2 jours ouvrables à 20h00 UTC. L’attribut credit_policy.upcoming_attributes.effective_at représente cet horodatage.

Command Line
curl https://api.stripe.com/v1/issuing/credit_policy -u "sk_***:" -H "Stripe-Version: 2024-06-20; issuing_credit_beta=v2"

Consultez l’exemple de réponse suivant :

{
  "livemode": true,
  "upcoming_attributes": {
    "current_exposure_limit_amount": 11359999920,
    "reserve_multiplier_decimal": "2.4",
    "max_exposure_limit_amount": 13233333300,
    "funded_reserve_amount": 4733333300,
    "effective_at": 1729195200 // 2024-10-17 20:00:00 +0000 UTC
  }
}

Seule la partie fixe du max_exposure_limit_amount est soumise à un délai de T+2 jours ouvrables. Le max_exposure_limit_amount n’est pas un changement initié par Stripe et se met à jour de manière dynamique en fonction de votre réserve financée.

Par exemple, si vous demandez à Stripe d’augmenter la portion fixe de votre max_exposure_limit_amount de 1 000 USD, ce changement prend effet à T+2 jours ouvrables. Cependant, si vous augmentez votre funded_reserve de 1 000 USD, votre max_exposure_limit_amount change dynamiquement en temps réel.

Obligation du programme de carte

Bien que votre CreditPolicy définisse les paramètres généraux de votre programme de postfinancement, votre FundingObligation représente votre obligation actuelle envers Stripe pour les dépenses par carte sur l’ensemble de vos comptes connectés, ou sur votre compte si vous êtes un utilisateur direct.

Chaque matin, Stripe envoie un événement de webhook issuing_funding_obligation.updated contenant la FundingObligation que vous devez à Stripe. Pour une FundingObligation donnée, la valeur amount_outstanding représente le montant que vous devez ce jour-là.

{
 "id": "icfo_123",
 "amount_total": 95000000, // minor units
 "amount_outstanding": 95000000, // minor units
 "amount_paid": 0,
 "currency": "usd",
 "status": "unpaid",
 "due_at": "timestamp_on_t1",
 "paid_at": "nil",
 "owed_to": "stripe",
 "finalized_at": "timestamp_on_t2",
 "grace_period_ends_at": "timestamp_on_t3",
 …,
}

Paiements en retard

Chaque FundingObligation contient un champ due_at qui indique la date d’échéance de la FundingObligation.

{
 "id": "icfo_123",
 "amount_total": 95000000, // minor units
 "amount_outstanding": 95000000, // minor units
 "amount_paid": 0,
 "currency": "usd",
 "status": "unpaid",
 "due_at": "timestamp_on_t1",
 "paid_at": "nil",
 "owed_to": "stripe",
 "finalized_at": "timestamp_on_t2",
 "grace_period_ends_at": "timestamp_on_t3",
 …,
}

Si vous ne payez pas votre FundingObligation à la date d’échéance, voici ce qui se produit :

Stripe prélève des fonds sur votre réserve pour couvrir le montant impayé.
Si votre solde est suffisant dans votre réserve, vous recevez un webhook FundingObligation.updated indiquant que l’état de l’obligation de financement est passé à paid. Si le solde de la réserve est insuffisant pour couvrir l’intégralité de la FundingObligation, vous recevrez un webhook FundingObligation.updated indiquant que l’obligation de financement est passée à l’état past_due et affichant une date et heure de grace_period_ends_at à 20h00 UTC le jour ouvrable suivant.
En cas de prélèvement sur la réserve, les valeurs credit_policy.current_exposure_limit_amount et credit_policy.max_exposure_limit_amount reflètent la limite d’exposition mise à jour en fonction du nouveau solde de la réserve de crédit Issuing. Vous recevez un webhook vous informant des nouvelles limites d’exposition (actuelles et maximales).
Vous recevez également un e-mail vous informant du prélèvement effectué sur la réserve et de votre FundingObligation à l’état past_due.
En cas de retard de paiement de votre FundingObligation, Stripe vous facturera des frais de retard de paiement, comme indiqué dans votre contrat avec Stripe.
Il est de votre responsabilité de vous assurer que votre current_exposure_limit est supérieure à votre solde Issuing négatif. Soyez prêt à recharger votre réserve si nécessaire après un retrait effectué par Stripe. Dans le cas contraire, l’autorisation sera refusée si vos dépenses dépassent votre max_exposure_limit.

Des retards de paiement répétés peuvent entraîner des pénalités supplémentaires pour votre plateforme, comme une diminution de la limite d’exposition de votre programme de cartes. Vous devez remédier à une FundingObligation impayée dans un délai d’un jour ouvrable supplémentaire, faute de quoi Stripe pourrait commencer à refuser des transactions.

Déterminer le montant que vous devez à Stripe

Stripe génère une FundingObligation pour votre programme de carte tous les jours, y compris les week-ends et les jours fériés. Pour maintenir votre compte à jour et éviter les frais de retard et les pénalités, calculez le montant total dû chaque jour en vous basant sur la valeur amount_outstanding de toutes les FundingObligations à l’état unpaid ou past_due à l’aide d’une formule :

`total_amount_outstanding` = somme(unpaid FundingObligations)¹ + somme(past_due FundingObligations)²

La somme ¹sum(unpaid FundingObligations) correspond au total de toutes les FundingObligations avec status=unpaid.

²sum(past_due FundingObligations) est le total de toutes les FundingObligations dont status=past_due.

Gérer les obligations de financement et les dates d’échéance

Lorsque Stripe génère une FundingObligation un jour de semaine, celle-ci est due le jour même. Lorsque Stripe génère une FundingObligation pendant un week-end ou un jour férié, elle est due le jour ouvrable suivant. Pour un week-end typique, cela signifie que vous aurez trois FundingObligations à régler le lundi. Assurez-vous de calculer avec précision le montant total que vous devez à Stripe afin d’effectuer les paiements dans les délais.

Financer Stripe pour respecter ses obligations

Pour rembourser quotidiennement le montant total dû à Stripe en vous basant sur l’horodatage due_at, utilisez l’une des méthodes suivantes :

Virements bancaires le jour même : Effectuez un virement le jour même de votre banque vers votre solde Stripe Issuing pour régler une FundingObligation. Utilisez l’API FundingInstructions pour récupérer les numéros de compte et de routage de votre solde Issuing, et utilisez-les comme destination pour le virement.
Transferts de solde : Aux États-Unis, vous pouvez transférer instantanément de l’argent de votre solde de paiements Stripe vers votre solde Issuing et l’utiliser pour rembourser votre FundingObligation via le Dashboard Stripe ou l’API (contactez Stripe pour accéder à l’API).
Solde Issuing préfinancé existant : Aux États-Unis, Stripe applique tout montant préfinancé ou surfinancé de la veille à votre prochaine FundingObligation. Dans la région EMEA, le préfinancement de votre solde Issuing n’est pas autorisé pour les utilisateurs de cartes à débit différé. En revanche, tout solde Issuing positif est transféré dans votre réserve Issuing.

Une fois que Stripe a reçu l’intégralité du montant dû sur la FundingObligation, nous mettons à jour son état et ses montants, et nous déclenchons un événement de webhook issuing_funding_obligation.updated.

{
 "id": "icfo_123",
 "amount_total": 95000000, // minor units
 "amount_outstanding": 0,
 "amount_paid": 95000000, // minor units
 "currency": "usd",
 "status": "paid",
 "due_at": "timestamp_on_t1",
 "paid_at": "timestamp_of_payment",
 "owed_to": "stripe",
 "grace_period_ends_at": "timestamp_on_t2"
 …,
}

Si vous ne payez qu’une partie du montant total dû, Stripe met à jour les montants, mais conserve l’état unpaid. L’événement de webhook issuing_funding_obligation.updated reflète ces informations.

{
 "id": "icfo_123",
 "amount_total": 95000000, // minor units
 "amount_outstanding": 3000000, // minor units
 "amount_paid": 92000000, // minor units
 "currency": "usd",
 "status": "unpaid",
 "due_at": "timestamp_on_t1",
 "paid_at": "timestamp_of_payment",
 "owed_to": "stripe",
 "grace_period_ends_at": "timestamp_on_t2"
 …,
}

Si le solde reste impayé au-delà de la date due_at, le status passe à past_due, ce qui déclenche un autre événement de webhook issuing_funding_obligation.updated et déclenche un retrait de fonds de la réserve.

Récupérer les opérations correspondant à une obligation de financement

Récupérez la liste des transactions qui contribuent à une FundingObligation en incluant l’un des paramètres suivants dans la requête API permettant de lister toutes les transactions :

funding_obligation_for_account pour les utilisateurs directs.
funding_obligation_for_platform pour les utilisateurs de type plateforme.

Pour récupérer des opérations liées à des paiements directs :

Consultez l’exemple de réponse suivant :

{
 "object": "list",
 "url": "/v1/issuing/transactions",
 "has_more": false,
 "data": [
   {
     "id": "ipi_123",
     "object": "issuing.transaction",
     // various other fields
     "funding_obligation_for_platform": null,
     "funding_obligation_for_account": "ifo_123",
     // various other fields
   },
   {
     "id": "ipi_123",
     "object": "issuing.transaction",
     // various other fields
     "funding_obligation_for_platform": null,
     "funding_obligation_for_account": "ifo_123",
     // various other fields
   },
   {...}
 ]
}

Interroger les obligations de financement des comptes connectés

Les plateformes Connect doivent inclure l’ID du compte connecté dans l’en-tête Stripe-Account. Utilisez funding_obligation_for_platform pour effectuer une requête d’après la valeur FundingObligation de la plateforme, ou utilisez funding_obligation_for_account si vous connaissez la FundingObligation d’un compte connecté.

Consultez l’exemple de réponse suivant :

{
 "object": "list",
 "url": "/v1/issuing/transactions",
 "has_more": false,
 "data": [
   {
     "id": "ipi_123",
     "object": "issuing.transaction",
     // various other fields
     "funding_obligation_for_platform": "ifo_123",
     "funding_obligation_for_account": "ifo_456",
     // various other fields
   },
   {
     "id": "ipi_123",
     "object": "issuing.transaction",
     // various other fields
     "funding_obligation_for_platform": "ifo_123",
     "funding_obligation_for_account": "ifo_789",
     // various other fields
   },
   {...}
 ]
}

Gérer votre réserve

Vous devez déposer une réserve (appelée « garantie » dans votre contrat de programme) auprès de Stripe afin d’utiliser des dépenses par carte postfinancées à bon rendement en capital. Stripe place la réserve sur un compte qu’elle détient et contrôle à titre de garantie sur les fonds dus, et y puise pour rembourser les FundingObligations en retard ou impayées. Stripe utilise également le montant de la réserve comme base pour les calculs des valeurs current_exposure_limit et max_exposure_limit. Vous pouvez ajuster le solde de votre réserve de façon dynamique en ajoutant des fonds lorsque vous prévoyez des dépenses plus élevées, par exemple avant un long week-end, et en réduisant votre réserve lorsque vos dépenses prévues sont plus faibles.

Vous pourriez devoir payer des frais de retard si votre obligation de financement passe à l’état past_due et que votre réserve n’est pas suffisante pour couvrir le montant. De plus, un excès d’obligations de financement à l’état past_due peut conduire Stripe à réduire le reserve_multiplier_decimal de votre plateforme ou la partie fixe de votre max_exposure_limit_amount. Pour éviter cette situation, approvisionnez votre solde Stripe Issuing par virement bancaire ou transferts de solde avant la date et l’heure due_at de laFundingObligation dans votre intégration de crédit.

Identifiez les composantes de votre réserve

Vous pouvez identifier les valeurs de reserve_multiplier_decimal, max_exposure_limit_amount, funded_reserve_amount, et current_exposure_limit_amount dans votre CreditPolicy. Utilisez ces facteurs, ainsi que vos dépenses futures prévues, pour déterminer la valeur de funded_reserve_amount appropriée.

Command Line
curl https://api.stripe.com/v1/issuing/credit_policy -u "sk_***:" -H "Stripe-Version: 2024-06-20; issuing_credit_beta=v2"

Consultez l’exemple de réponse suivant :

{
  "current_exposure_limit_amount": 11359999920 ,
   "reserve_multiplier_decimal": "2.4",
   "max_exposure_limit_amount": 13133333300,
   "funded_reserve_amount": 4733333300,
    // other fields
}

Ajouter des fonds au solde de votre réserve

Stripe prend en charge le transfert de fonds vers le solde de réserve. Vous pouvez avoir recours à cette stratégie pour augmenter votre current_exposure_limit_amount en prévision d’une augmentation des dépenses ou après que Stripe ait effectué un retrait de votre réserve afin de payer une FundingObligation à l’état past_due. Vous trouverez les renseignements relatifs au compte associé à votre réserve dans la FundingInstruction, qui contient les numéros de compte bancaire et de routage nécessaires au transfert de fonds.

Mise en garde

Ces instructions diffèrent de celles que Stripe utilise pour financer votre solde Issuing. Le paramètre destination_balance des instructions de financement de votre réserve doit correspondre à issuing_credit_reserved.

Consultez l’exemple de réponse suivant :

{
 "id": "fi_XYZ",
 "object": "funding_instruction",
 "livemode": "true",
 "currency": "usd",
 "bank_transfer": {
   "type": 'us_bank_account',
   "country": "US",
   "financial_addresses": [{
     "supported_networks": ['ach', 'domestic_wire_us'],
     "type": 'aba',
     "aba": {
       "account_number": "546475644",
       "bank_name": "Wells Fargo",
       "routing_number": "123456"
     },
   }]
 },
 "destination_balance": "issuing_credit_reserved",
 "funding_type": "bank_transfer",
}

Les fonds transférés par virement bancaire ACH sur le compte bancaire extrait des FundingInstructions sont déposés dans votre solde de réserve. Lorsque les fonds arrivent sur votre compte, Stripe envoie une notification de webhook topup.succeeded ainsi qu’un événement de webhook issuing_credit_policy.updated représentant l’actualisation de votre limite d’exposition et le montant de la réserve financée. Stripe n’ajoute pas de délais supplémentaires au transfert bancaire et suit généralement les délais standard.

{
 "id": "tu_XYZ",
 "object": "topup",
 "amount": 9000,
 "balance_transaction": "txn_123",
 "destination_balance": "issuing_credit_reserved"
 "created": 123456789,
 ...
}

Consulter le solde de votre réserve

Vous pouvez utiliser l’API Balance pour consulter le solde de votre réserve à tout moment :

Consultez l’exemple de réponse suivant :

{
 "object": "balance",
 "available": [ ... ],
 "connect_reserved": [ ... ],
 "issuing": { ... },
 "issuing_credit_reserved": [
   {
   "amount": 9000,
   "currency": "usd"
   }
 ],
 "livemode": true,
 "pending": [ ... ]
}

Gérer les obligations de financement en souffrance

Si vous avez une FundingObligation à l’état past_due, Stripe effectue d’abord un retrait de votre réserve pour rembourser la FundingObligation. Stripe utilise le webhook issuing_funding_obligation.updated pour vous notifier et met à jour l’objet FundingObligation de manière à y indiquer le montant remboursé par votre réserve. Si votre réserve ne peut pas couvrir entièrement la valeur amount_outstanding de la FundingObligation, la FundingObligation reste à l’état past_due. Pour en savoir plus et découvrir les implications, consultez la section dédiée aux obligations de financement en souffrance.

L’exemple suivant affiche une FundingObligation intégralement remboursée à l’aide des fonds présents sur la réserve :

{
 "id": "icfo_123"
 "amount_total": 95000000, // minor units
 "amount_outstanding": 0,
 "amount_paid": 95000000, // minor units
 "amount_paid_from_reserve": 95000000, // minor units
 "currency": "usd",
 "status": "paid",
 "due_at": "timestamp_on_t1",
 "paid_at": "timestamp_of_payment_with_reserve",
 "owed_to": "stripe",
 "grace_period_ends_at": "timestamp_on_t2",
 …,
}

Stripe fournit un objet BalanceTransfer et des BalanceTransactions associées pour représenter le transfert automatisé de fonds de votre solde de réserve vers votre solde Issuing.

Consultez l’exemple de réponse suivant :

{
 "id": "btr_1MinsBCq7itcH1tbDkk4sY8w",
 "object": "balance_transfer",
 "amount": 10000,
 "currency": "usd",
 "destination_balance": {
   "issuing": {
     "balance_transaction": "txn_123_inbound"
   },
   "type": "issuing"
 },
 ...
 "source_balance": {
   "issuing_credit_reserved": {
     "balance_transaction": "txn_123_outbound"
   },
   "type": "issuing_credit_reserved"
 }
}

Consultez l’exemple de réponse suivant :

{
 "id": "txn_123_outbound",
 "object": "balance_transaction",
 "amount": 100,
 "currency": "usd",
 ...
 "type": "balance_transfer_outbound",
 "balance_type": "issuing_credit_reserved",
 "reporting_category": "issuing_credit_reserved_funds"
}


{
 "id": "txn_123_inbound",
 "object": "balance_transaction",
 "amount": 100,
 "currency": "usd",
 ...
 "type": "balance_transfer_inbound",
 "balance_type": "issuing",
 "reporting_category": "issuing_credit_reserved_funds"
}

Virer des fonds à partir de votre solde de réserve

Stripe prend en charge le virement de fonds à partir de votre solde de réserve. Vous pouvez avoir recours à cette stratégie pour réduire votre current_exposure_limit_amount avant de réduire vos dépenses afin d’augmenter l’efficacité du capital. Vous pouvez utiliser l’endpoint v1/payout avec source_type défini sur issuing_credit_reserved.

Mise en garde

Command Line
curl https://api.stripe.com/v1/payouts \
  -u "sk_**:" \
  -d amount=100000000 \
  -d currency=usd \
  -d source_type=issuing_credit_reserved

Une fois que vous avez créé un virement, Stripe envoie immédiatement un webhook indiquant que le solde de la réserve de crédit émise reflète le virement créé. Consultez l’exemple de réponse suivant :

curl https://api.stripe.com/v1/balance -u "sk_**:" -H "Stripe-Version: 2024-06-20; issuing_credit_beta=v2"
{
  // other fields,
  "issuing_credit_reserved": [
    {
      "amount": 1233333300,
      "currency": "usd"
    }
  ],

}

L’objet Credit Policy reflète la limite d’exposition la plus récente et vous recevez un webhook issuing_credit_policy.updated vous informant des nouvelles limites d’exposition.

Consultez l’exemple de réponse suivant :

curl https://api.stripe.com/v1/issuing/credit_policy -u "sk_***:" -H "Stripe-Version: 2024-06-20; issuing_credit_beta=v2"


{
  "object": "issuing.credit_policy",
   "current_exposure_limit_amount": 11359999920 ,
   "reserve_multiplier_decimal": "2.4",
   "max_exposure_limit_amount": 13133333300,
   "funded_reserve_amount": 4733333300,
    // other fields
}

Consultez l’exemple de réponse suivant :

{
 "object": {
  "object": "issuing.credit_policy",
  "credit_period_ends_on_days": null,
  "credit_period_interval": "day",
  "credit_period_interval_count": 1,
  "current_exposure_limit_amount": 240,
  "days_until_due": 0,
  "exposure_limit_currency": "usd",
  "funded_reserve_amount": 200,
  "last_effective_attributes": {
   "credit_period_ends_on_days": null,
   "credit_period_interval": "day",
   "credit_period_interval_count": 1,
   "current_exposure_limit_amount": 103,
   "days_until_due": 0,
   "effective_until": 1728763199,
   "max_exposure_limit_amount": 103,
   "reserve_multiplier_decimal": "1.300",
   "status": "active"
  }}}

Dans l’exemple ci-dessus, si vous envoyez votre demande de virement du mardi au vendredi avant 10h00 UTC, le virement est décaissé le même jour. Si vous envoyez votre demande de virement après ce délai, il est fort probable qu’elle soit décaissée d’ici la fin du jour ouvrable suivant. Le lundi ou après un week-end avec pont, prévoyez un délai supplémentaire d’un jour. Même si vous effectuez le virement avant 10h00 UTC, le virement est décaissé à la fin de la journée suivant le jour ouvrable suivant.

Montant disponible pour les dépenses du programme de cartes

Pour ajouter un champ ou un solde indiquant le montant dont dispose votre programme de cartes, utilisez la formule suivante :

crédit disponible = `max_exposure_limit` + solde Issuing (le solde Issuing peut être négatif en raison de dépenses supplémentaires autorisées par la limite d’exposition)

Refus d’autorisation sur les post-financements

Lors d’un post-financement, les autorisations peuvent être refusées pour les raisons suivantes :

FundingObligations est past_due
Vous dépassez votre max_exposure_limit_amount

Refus de paiement sur des obligations de financement en souffrance

Stripe refuse les autorisations lorsqu’une FundingObligation est à l’état past_due et que la période de grâce définie dans l’horodatage grace_period_ends_at de la FundingObligation est écoulée. Pour trouver le paramètre grace_period_ends_at, procédez comme suit :

{
 "id": "icfo_123",
 "amount_total": 95000000, // minor units
 "amount_outstanding": 95000000, // minor units
 "amount_paid": 0,
 "currency": "usd",
 "status": "past_due",
 "due_at": "timestamp_on_t1",
 "paid_at": nil,
 "owed_to": "stripe",
 "grace_period_ends_at": "timestamp_on_t2",
 ...,
}

Si la période de grâce est écoulée, Stripe Issuing refuse les autorisations et envoie les événements issuing_authorization.created avec les éléments suivants` :

{
 "id": "iauth_123",
 "object": "issuing_authorization",
 "approved": false,
 ...,
 "status": "closed",
 "request_history": [
   {
     "amount": 100, // minor units
     "approved": false,
     "reason": "past_due_funding_obligation_to_stripe",
     ...,
   }
 ]
}

Refus de paiement en raison de la limite d’exposition maximale

Stripe commence immédiatement à refuser des autorisations lorsque vous atteignez ou dépassez votre max_exposure_limit. Vous pouvez ajouter des réserves pour augmenter la limite et éviter les refus de paiement.

En cas de dépassement de votre max_exposure_limit, Stripe Issuing refuse les autorisations et envoie les événements issuing_authorization.created avec les éléments suivants :

{
 "id": "iauth_123",
 "object": "issuing_authorization",
 "approved": false,
 ...,
 "status": "closed",
 "request_history": [
   {
     "amount": 100, // minor units
     "approved": false,
     "reason": "platform_exposure_limit_exceeded",
     ...,
   }
 ]
}

Gérer les notifications post-financement par e-mail de votre plateforme

Stripe envoie plusieurs notifications obligatoires par e-mail après le financement. Vous pouvez gérer et définir des seuils pour les notifications par e-mail suivantes dans vos paramètres de notification de solde :

Notification d’un retrait de réserve initié par Stripe en raison d’une FundingObligation impayée.
Notification d’une FundingObligation qui passe à l’état past_due lorsque votre réserve est insuffisante pour la couvrir.
Notification indiquant que votre solde Issuing négatif a dépassé 90 % de votre max_exposure_limit_amount.

Si vous le souhaitez, vous pouvez configurer le seuil dans le Dashboard pour recevoir des notifications lorsque le solde Issuing négatif de votre plateforme dépasse un seuil correspondant à un pourcentage de votre valeur current_exposure_limit.