Abonnements

# 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).