Rolebase Développeurs
Référence API

org_subscription

Suit le plan d'abonnement, le statut de paiement et les détails d'intégration Stripe pour une organisation.

Champs

Champ Type Description
id uuid Identifiant unique de l'abonnement
orgId uuid Référence à l'organisation
type Subscription_Plan_Type_Enum Type de plan d'abonnement (Startup ou Business)
status Subscription_Payment_Status_Enum Statut de paiement actuel de l'abonnement
stripeCustomerId String Identifiant client Stripe pour la facturation
stripeSubscriptionId String Identifiant d'abonnement Stripe pour les paiements récurrents (optionnel)

Types de plans d’abonnement

  • Startup — Plan de base pour les startups et les petites équipes
  • Business — Plan avancé pour les grandes organisations

Statuts de paiement

  • active — L’abonnement est actif et payé
  • canceled — L’abonnement a été annulé
  • incomplete — La tentative de paiement initiale a échoué
  • incomplete_expired — La tentative de paiement initiale a échoué et a expiré
  • past_due — Le paiement est en retard
  • paused — L’abonnement est temporairement suspendu
  • trialing — En période d’essai
  • unpaid — Le paiement a échoué et l’abonnement est impayé

Relations

Relations objet :

  • org — L’organisation à laquelle cet abonnement appartient

Exemples de requêtes

Obtenir l’abonnement d’une organisation

query GetOrgSubscription($orgId: uuid!) {
  org_subscription(where: { orgId: { _eq: $orgId } }) {
    id
    type
    status
    org {
      name
    }
    stripeCustomerId
    stripeSubscriptionId
  }
}

Permissions

  • Tous les membres de l’organisation peuvent consulter les détails de l’abonnement
  • La gestion des abonnements se fait via la plateforme Rolebase
  • Les modifications directes sont restreintes aux processus système
Warning 2 Lecture seule

Chaque organisation ne peut avoir qu’un seul abonnement. Les champs orgId, stripeCustomerId et stripeSubscriptionId sont uniques. Le statut de l’abonnement est automatiquement mis à jour via les webhooks Stripe.