Configurer un crédit pour vos comptes connectésVersion bêta privée
Découvrez comment configurer les conditions de crédit de vos comptes connectés et financer leurs achats à partir de votre plateforme.
Les API Credit permettent de gérer les conditions de crédit de vos comptes connectés. Selon votre politique de crédit avec votre banque partenaire, vous pouvez sélectionner les comptes connectés pouvant bénéficier d’une ligne de crédit, définir la période et le plafond de leur crédit, et les autoriser à effectuer des dépenses et à les rembourser à la fin de leur période de crédit.
Prérequis
- Register your platform.
- Ajoutez des informations sur l’entreprise pour activer votre compte.
- Complétez votre profil de plateforme.
- Personnalisez les paramètres de marque. L’ajout du nom de l’entreprise, d’une icône et d’une couleur de marque est obligatoire pour Connect Onboarding.
- La version bêta d’Issuing Credit est activée pour votre compte. Contactez le représentant de votre compte Stripe pour plus d’informations.
Consultez le guide de création de comptes Custom Connect pour procéder à la configuration.
Demander la fonctionnalité `card_issuing_charge_card` pour vos comptes connectés
Outre la fonctionnalité transfers requise pour émettre des cartes, vous devez activer la fonctionnalité card_ pour chaque compte connecté dont vous souhaitez financer les achats à l’aide des fonds disponibles de votre plateforme (et des ressources de votre plateforme, en cas de préfinancement). La fonctionnalité card_ permet à un compte connecté d’émettre des cartes depuis son compte et d’effectuer des paiements dans la limite de son plafond de crédit, tant que votre plateforme Issuing dispose de fonds suffisants pour couvrir ces paiements. Si vous créez un nouveau compte connecté sur votre plateforme, vous pouvez demander la fonctionnalité card_ de la même manière que n’importe quelle autre fonctionnalité. Pour accorder la fonctionnalité card_ à un compte connecté existant, effectuez la demande via un appel de modification de compte à l’API.
Enregistrer les détails de la demande de l'utilisateur et la limite de crédit approuvée
Chaque fois qu’un utilisateur remplit et envoie une demande de crédit à votre plateforme, enregistrez les détails de sa demande et la décision d’approuver ou de refuser avec l’API Credit Underwriting Record.
Tout d’abord, utilisez l’endpoint create_from_application pour enregistrer l’heure d’envoi de la demande, le motif de la demande (credit_ pour les nouveaux utilisateurs), ainsi que le nom (name) et l’adresse email du demandeur dans le hachage credit_user. Vous pouvez spécifier le mode de réception de la demande avec application_method, mais si vous ne spécifiez pas de valeur, sa valeur par défaut sera online.
Exemple de réponse
{ "object": "issuing.credit_underwriting_record", "id": "cur_1NiHAD2eZvKYlo2CmWGpt5OX", "credit_user": { "name": "Barbell Gym", "email": "barbell-gym@gmail.com" }, "created_from": "application", "application": { "purpose": "credit_line_opening", "submitted_at": 1681138952, "application_method": "online" }, "decision_deadline": 1683601352 // 30 days after submission }
Pour approuver la demande, utilisez l’endpoint report_decision avec l’ID de la réponse, définissez le type de décision sur credit_ et spécifiez le montant approuvé.
Toutes les demandes reçues doivent être enregistrées. Consultez la section Déclarer d’autres décisions de crédit pour savoir comment déclarer les demandes rejetées, incomplètes ou retirées par le demandeur.
Accepter les Conditions des cartes à débit différé pour activer la fonctionnalité `card_issuing_charge_card`
Une fois que vous avez demandé la fonctionnalité card_ pour un compte connecté, activez-la en satisfaisant les exigences card_ et en acceptant les contrats relatifs aux comptes connectés, notamment les Conditions d’utilisation de la carte à débit différé de Cross River Bank.
Ces conditions établissent la relation entre la banque partenaire à l’origine du crédit et le compte connecté. Elles doivent être visibles dans votre flux d’inscription, et vous devez recueillir le consentement explicite de votre utilisateur.
Incluez également des Conditions d’utilisation des cartes à débit différé, qui s’appliqueront aux relations entre votre compte connecté et vous. Reprenez les principales Conditions de votre politique de crédit avec le partenaire bancaire, notamment les frais, la période de remboursement, les récompenses et les règles relatives à la définition de la limite de crédit d’un compte connecté. Enregistrez l’acceptation dans l’API seulement quand le compte a accepté les Conditions dans votre flux d’inscription des utilisateurs.
Déterminer la période de crédit et activer la ligne de crédit
Avant d’entreprendre toute action décrite dans cette section, consultez la politique de crédit de votre partenaire bancaire.
La politique de crédit CreditPolicy stocke le plafond de crédit et la période de crédit de votre compte connecté.
Lorsque la fonctionnalité card_ devient active, Stripe crée une CreditPolicy vide et inactive pour le compte connecté, ce qui déclenche l’événement de webhook issuing_.
Pour définir l’attribut credit_ vous devez reprendre le montant que vous avez approuvé dans la décision correspondant à la demande, sans quoi la CreditPolicy renverra une erreur.
Imaginons que Gymbox souhaite octroyer à Barbell (une salle de sport) un crédit dont le plafond est de 1 000 USD, à rembourser le 15 de chaque mois. Gymbox effectue l’appel suivant pour configurer le compte connecté de Barbell :
Vous pouvez définir la propriété credit_ 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": null, "credit_period_interval": null, "credit_period_interval_count": null, "credit_period_ends_on_days": null, "days_until_due": null, "status": "inactive", }, "upcoming_attributes": null }
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.
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": null }
Chacune de ces actions déclenche des instances distinctes de l’événement de webhook issuing_.
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_.
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.
Créer des cartes et des titulaires de cartes
After you set up your connected account for credit by activating the CreditPolicy, you can generate virtual or physical cards for your connected account to use against their credit limit.