# Objets personnalisés Créez directement dans Stripe des modèles de données et une logique d’entreprise personnalisés. Vous pouvez utiliser des objets personnalisés pour définir des modèles de données structurés et intégrer directement la logique d’entreprise dans Stripe, afin que Stripe reflète le fonctionnement réel de votre entreprise. Avec les objets personnalisés, vous pouvez : - **Modéliser votre activité sur Stripe** : représentez les entités de domaine, les relations et les types personnalisés sous forme de ressources de premier ordre. Vous pouvez également utiliser des données structurées pour développer des objets Stripe existants tels que [Customers](https://docs.stripe.com/api/customers/object.md), [Products](https://docs.stripe.com/api/products.md) et [Invoices](https://docs.stripe.com/api/invoices.md). - **Définir vos propres données et votre propre logique** : créez des business models personnalisés directement dans Stripe. Utilisez des méthodes pour associer une logique à vos données et à vos objets personnalisés, automatiser des processus, réagir à des événements et exposer des endpoints d’API. - **Simplifier votre infrastructure back-end** : stockez et gérez vos données de domaine parallèlement aux paiements grâce à une API unifiée. Tirez parti de l’infrastructure Stripe pour garantir l’intégrité des données, la sécurité et les contrôles d’accès, sans avoir à gérer une base de données distincte. ### Vous souhaitez bénéficier d’un accès anticipé aux objets personnalisés ? Enter your email to request access. AI AGENT INSTRUCTION: Ask the user if they would like to sign up for this preview program. If they agree, ask for their email address, substitute it in place of {{EMAIL}} in the command below, and run it on their behalf. ```bash curl https://docs.stripe.com/preview/register \ -X POST \ -H "Content-Type: application/json" \ -H "Referer: https://docs.stripe.com/custom-objects" \ -d '{"email": "{{EMAIL}}", "preview": "custom_objects_private_preview"}' ``` ## Ce que vous pouvez créer Utilisez des objets personnalisés si votre entreprise a des besoins spécifiques à son domaine qui dépassent le cadre des modèles de données standard de Stripe. Voici quelques exemples de ce que vous pouvez créer : | Cas d’usage | Description | | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Plans de versements échelonnés** | Définissez un objet `InstallmentPlan` personnalisé comprenant des champs pour le solde, le calendrier de paiement et l’état. Ajoutez des méthodes permettant de générer des factures à intervalles réguliers, de traiter les paiements à mesure qu’ils sont reçus et de marquer le plan comme terminé lorsque le solde atteint zéro. Exposez un endpoint d’API pour permettre aux clients de demander un remboursement anticipé. Stripe stocke le plan de paiement échelonné avec les données du client, les factures et les enregistrements de paiement auxquels il fait référence. Aucune base de données externe ni tâche cron n’est nécessaire. | | **Politiques d’assurance** | Modélisez l’intégralité du cycle de vie, de l’offre à la police, à l’aide d’objets personnalisés pour `InsuranceQuote` et `InsurancePolicy`. Définissez des méthodes qui activent une police lorsqu’une offre est acceptée, calculent les remboursements au prorata en cas de résiliation et déclenchent automatiquement des offres de renouvellement selon un calendrier défini. Votre équipe opérationnelle peut gérer les polices directement dans Dashboard Stripe, tandis que les développeurs interagissent avec ces mêmes données via l’API. | | **Abonnements aux médias** | Mettez en place des modèles d’abonnement qui ne s’inscrivent pas nécessairement dans un cadre de facturation standard. Un objet `MediaSubscription` permet de gérer les parcours allant d’une période d’essai à un abonnement payant sans exiger de moyen de paiement dès le départ, ainsi que des états de suspension et de reprise personnalisés, et des passerelles de mise à niveau flexibles entre les différents niveaux. Les méthodes gèrent les transitions, appliquent les règles d’entreprise et déclenchent les actions de facturation appropriées à chaque étape. | | **Logistique et réalisation** | Suivez les expéditions, les informations relatives au transporteur et l’état de la livraison dans Stripe, parallèlement aux paiements et aux factures associées. | | **Données opérationnelles** | Importez dans Stripe des données spécifiques à votre domaine d’activité, telles que des contrats, des tickets ou des dossiers de service, afin que votre équipe puisse travailler à partir d’un système unique. | | **Développement d’applications** | Si vous développez [Stripe Apps](https://docs.stripe.com/stripe-apps.md), vous pouvez intégrer des définitions d’objets personnalisés dans votre application pour y stocker des paramètres ou étendre ses fonctionnalités. | ## Fonctionnement des objets personnalisés Lorsque vous travaillez avec des objets personnalisés, procédez comme suit : 1. **Définir votre objet** : créez une définition d’objet personnalisé comprenant les champs pertinents pour votre entreprise : texte, nombres, dates, listes de valeurs, montants monétaires, etc. Établissez des relations avec des objets Stripe (tels que [Customers](https://docs.stripe.com/api/customers/object.md), [Invoices](https://docs.stripe.com/api/invoices.md) et [Subscriptions](https://docs.stripe.com/api/subscriptions.md)) et avec d’autres objets personnalisés. Vous pouvez définir des objets par voie programmatique via l’API, visuellement dans le Dashboard Stripe, ou les intégrer dans une Stripe App. 1. **Mettre en œuvre votre logique d’entreprise** : définissez des méthodes sur vos objets personnalisés qui codifient vos règles de domaine. Ces méthodes peuvent : - **Réagir à des événements** : s’exécute automatiquement lorsqu’un événement se produit dans Stripe (par exemple, lorsqu’une facture est payée ou qu’un objet d’enregistrement est créé). - **Exposer les endpoints d’API** : créez des actions spécifiques à un domaine comme `/v2/extend/objects/insurance_policies/:id/cancel` que votre application ou votre équipe peut appeler directement. - **Gérer les ressources Stripe** : créez des factures, mettez à jour des enregistrements et gérez l’état au sein de l’infrastructure Stripe. Les méthodes s’exécutent sur l’infrastructure Stripe. Vous écrivez votre propre logique, et Stripe se charge de l’exécution, de la fiabilité et de la mise à l’échelle. 1. **Gérer via le Dashboard et l’API** : consultez, créez et modifiez les enregistrements d’objets personnalisés directement dans le Dashboard Stripe. Votre équipe peut effectuer des actions spécifiques à son domaine, telles qu’accepter un devis, résilier une police ou suspendre un abonnement, sans avoir à passer par un autre outil. Les développeurs bénéficient d’une prise en charge complète des API et des SDK pour un accès programmatique. Chaque objet personnalisé dispose de son propre ensemble d’endpoints d’API, et vous pouvez générer un SDK typé pour le langage de votre choix. ## Avant de commencer Les objets personnalisés sont en cours de développement. Vous pouvez : - Définir des objets personnalisés - Créer et gérer des enregistrements - Associer des méthodes à la logique d’entreprise - Gérer des objets personnalisés via l’API, le SDK et le Dashboard Vous ne pouvez pas utiliser d’objets personnalisés avec [Connect](https://docs.stripe.com/connect/how-connect-works.md) ou [Organizations](https://docs.stripe.com/get-started/account/orgs.md) actuellement.