# abonnements
La fonctionnalité d’abonnement définit les opérations d’abonnement et de plan du propriétaire du compte exposées via les routes proxy d’Inbox Manager. Il donne aux propriétaires un contrôle direct sur le cycle de vie du plan tout en assurant des contrôles stricts des comptes et des rôles.
Pourquoi c’est important
Cette fonctionnalité consolide les actions d’abonnement du propriétaire sous la surface de l’API Inbox Manager tout en préservant les contrôles stricts des comptes et des rôles lors des réclamations de jetons du porteur. Il expose les opérations de paiement, de portail, de synchronisation et de changement de plan sans obliger les clients à dupliquer la logique d’orchestration des abonnements.
Flux de base
Opérations
| Opération | Point de terminaison | Objectif |
|---|---|---|
| Liste des abonnements | GET /api/subscriptions |
Récupérer les abonnements pour le compte sélectionné par jeton |
| Liste des fonctionnalités | GET /api/subscriptions/features |
Récupérer l’ensemble des fonctionnalités d’abonnement actif |
| Obtenir l’identité de l’abonnement | GET /api/subscriptions/identity |
Récupérer la liaison d’identité d’abonnement pour le compte |
| Liste des commerçants | GET /api/subscriptions/merchants |
Récupérer les options du commerçant/fournisseur |
| Synchroniser les abonnements | POST /api/subscriptions/sync |
Actualiser l’état de l’abonnement du fournisseur |
| Changer d’abonnement | POST /api/subscriptions/:subscription_id/change |
Modifier plan ou intervalle |
| Annuler l’abonnement | POST /api/subscriptions/:subscription_id/cancel |
Terminer le cycle de vie de l’abonnement |
| Créer une session de paiement | POST /api/subscriptions/stripe/checkout-session |
Commencer le paiement pour un forfait nouveau ou modifié |
| Créer une session de portail | POST /api/subscriptions/stripe/portal-session |
Portail d’abonnement libre-service ouvert |
| Synchroniser la session de paiement | POST /api/subscriptions/stripe/checkout-session-sync |
Lier la fin du paiement à l’état de l’abonnement |
Données clés et état
{
data: {
account_id: "acc_...",
subscription_id: "sub_...",
status: "active"
},
links: {
checkout_url: "https://checkout.stripe.com/..."
}
}Toutes les réponses utilisent des charges utiles de style enveloppe proxy saisies par data avec links en option.
Modes de défaillance et contrôles
La revendication acc manquante ou non valide rejette les opérations d’abonnement du propriétaire et les appelants non propriétaires sont bloqués des actions d’abonnement au niveau du propriétaire. Les échecs du proxy en amont sont renvoyés sous forme d’échecs d’opération explicites, et la mutation d’abonnement reste limitée aux modifications explicites ou à l’annulation des routes.
Connexes
[Enveloppe proxy d’abonnement] (/fr/types/subscription-proxy-envelope), [11-subscription-owner-control] (/fr/guides/11-subscription-owner-control).