# Objets personnalisés

Définissez vos propres modèles de données dans Stripe.

Les objets personnalisés vous permettent de définir vos propres modèles de données dans Stripe, afin que Stripe reflète le fonctionnement de votre entreprise. Vous disposez peut-être de données qui ne correspondent pas aux objets standard de Stripe, comme des informations sur les expéditions, les réservations ou les appareils. Vous pouvez les définir dans Stripe, aux côtés des clients, des abonnements, des factures et des autres données Stripe auxquelles elles se rapportent. Conservez votre système de référence actuel et importez les données dont votre intégration Stripe a besoin, ou faites des objets personnalisés le système de référence pour ces données. Les objets personnalisés vous permettent de&nbsp;:

- **Définir votre activité sur Stripe**&nbsp;: représentez les entités de votre entreprise, leurs relations et leur cycle de vie sous forme de ressources typées. Référencez directement des objets Stripe tels que [Customer](https://docs.stripe.com/api/customers/object.md), [Invoice](https://docs.stripe.com/api/invoices/object.md) et [Subscription](https://docs.stripe.com/api/subscriptions/object.md) depuis vos propres objets.
- **Définir vos données dans le code**&nbsp;: décrivez vos objets en TypeScript et regroupez-les dans une [application Stripe](https://docs.stripe.com/stripe-apps.md). Lorsque vous chargez l’application, Stripe crée les endpoints d’API de vos objets et vous pouvez générer un SDK typé à partir de vos définitions.
- **Exploiter vos données**&nbsp;: recherchez vos enregistrements, réagissez aux modifications à l’aide d’événements et de [Workflows](https://docs.stripe.com/workflows.md), et créez vos propres vues de vos enregistrements dans le Dashboard avec les [Stripe Apps](https://docs.stripe.com/stripe-apps.md).
- **Réduire la complexité du back-end**&nbsp;: stockez et gérez les données de votre entreprise aux côtés de vos données Stripe à l’aide d’une API unique et cohérente, sans avoir à gérer une base de données distincte uniquement pour les stocker.

Les objets personnalisés sont proposés en [version bêta privée](https://docs.stripe.com/release-phases.md).

### Vous souhaitez bénéficier d’un accès anticipé aux objets personnalisés&nbsp;?

Enter your email to request access.

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

Les objets personnalisés conviennent aux entreprises dont les données vont au-delà de celles couvertes par les objets Stripe standard. Par exemple&nbsp;:

- **Abonnements liés au matériel**&nbsp;: suivez les appareils, leur lieu d’installation et leur cycle de vie à côté des abonnements qui les facturent.
- **Réservations et séjours**&nbsp;: regroupez les réservations et les préférences des clients avec les paiements et les factures qu’elles permettent d’expliquer.
- **Expéditions et exécution des commandes**&nbsp;: suivez les expéditions et leur statut de livraison à côté des factures qu’elles permettent d’honorer.
- **Demandes des clients et suivis**&nbsp;: suivez les demandes d’annulation et de remboursement, et utilisez les Workflows pour effectuer les modifications correspondantes dans Stripe.
- **Dashboards opérationnels dans Stripe**&nbsp;: créez une application en pleine page qui permet à votre équipe de gérer vos enregistrements et les objets Stripe auxquels ils font référence depuis un seul et même endroit dans le Dashboard.

Pour découvrir d’autres exemples et savoir dans quels cas utiliser les objets personnalisés, consultez la section [Cas d’usage des objets personnalisés](https://docs.stripe.com/custom-objects/use-cases.md).

## Fonctionnement des objets personnalisés

Vous définissez vos objets une seule fois, puis vous gérez leurs enregistrements dans l’ensemble de Stripe&nbsp;:

1. **Définir votre objet**&nbsp;: créez une définition d’objet avec les champs dont votre entreprise a besoin. Vous définissez les objets dans le code et les intégrez à une application Stripe.
2. **Gérer les enregistrements**&nbsp;: créez, récupérez, mettez à jour, répertoriez, recherchez et supprimez des enregistrements via l’API `/v2/extend/objects/<plural_name>`. Vous pouvez également générer un SDK typé à partir de vos définitions.
3. **Réagir aux modifications**&nbsp;: chaque définition d’objet envoie des événements lorsque ses enregistrements sont modifiés. Utilisez-les pour déclencher des workflows ou mettre à jour vos autres systèmes.
4. **Consulter dans le Dashboard**&nbsp;: consultez vos définitions ainsi que vos enregistrements dans le Dashboard Stripe, où vous pouvez également les rechercher et les filtrer.

## Ce qui est disponible en version bêta privée

Dans la version bêta privée, vous pouvez&nbsp;:

- Définir des objets personnalisés dans le code et les intégrer à une application Stripe. Ils comportent des champs typés, des règles de validation et des références
- Créer, récupérer, mettre à jour, répertorier, rechercher et supprimer des enregistrements via l’API
- Générer un SDK Node.js typé à partir de vos définitions
- Publier de nouvelles versions de vos définitions d’objets personnalisés au fil de l’évolution de votre schéma
- Recevoir des événements pour chaque définition d’objet lorsque ses enregistrements sont modifiés
- Utiliser des objets personnalisés dans les Workflows, à la fois comme déclencheurs et comme étapes permettant de créer et de mettre à jour des enregistrements
- Créer des vues dans le Dashboard et des applications en pleine page pour consulter et gérer vos enregistrements à l’aide des Stripe Apps
- Consulter vos définitions ainsi que vos enregistrements dans le Dashboard, où vous pouvez également les rechercher et les filtrer (le Dashboard est en lecture seule pendant la version bêta privée)

Pendant la version bêta privée, les objets personnalisés fonctionnent au sein d’un seul compte Stripe. Le partage entre plusieurs comptes n’est pas pris en charge. Pour connaître les autres restrictions, consultez la section [Limites et limitations](https://docs.stripe.com/custom-objects/limitations.md).

## Étapes suivantes

- [Fonctionnement des objets personnalisés](https://docs.stripe.com/custom-objects/how-it-works.md)
- [Premiers pas avec les objets personnalisés](https://docs.stripe.com/custom-objects/get-started.md)
- [Définir des objets personnalisés](https://docs.stripe.com/custom-objects/define.md)
