Abonnements
AM gère le cycle de vie des abonnements Stripe pour les comptes, afin que vous puissiez vous concentrer sur la tarification et l’accès plutôt que sur les webhooks.
Créez des sessions de checkout, laissez les clients gérer leurs plans et gardez l’accès du compte synchronisé avec Stripe.
Flux d’Abonnement
Endpoints
| Endpoint | Objectif |
|---|---|
POST /api/accounts/:account_id/subscriptions/stripe/checkout-session | Démarrer le checkout d’abonnement |
POST /api/accounts/:account_id/subscriptions/stripe/portal-session | Ouvrir le portail client |
POST /api/accounts/:account_id/subscriptions/stripe/checkout-session-sync | Synchroniser checkout et abonnement |
POST /api/accounts/:account_id/subscriptions/sync | Synchroniser les abonnements Stripe |
POST /api/accounts/:account_id/subscriptions/change | Changer l’offre ou le prix |
POST /api/accounts/:account_id/subscriptions/cancel | Annuler l’abonnement |
GET /api/accounts/:account_id/subscriptions | Lister les abonnements |
GET /api/accounts/:account_id/subscriptions/features | Lister les fonctionnalités actives |
GET /api/accounts/:account_id/subscriptions/identity | Obtenir l’identité client Stripe |
POST /api/applications/:application_id/subscriptions/stripe/webhook | Webhook Stripe |
Session de Checkout
Crée une session Stripe Checkout pour de nouveaux abonnements :
// Request
{
price_id: "price_...",
success_url: "https://app.example.com/success",
cancel_url: "https://app.example.com/cancel"
}
// Response
{
url: "https://checkout.stripe.com/..."
}Redirigez les utilisateurs vers l’URL retournée. Après le paiement, Stripe redirige vers votre URL de succès.
Portail Client
Permet aux clients de gérer eux-mêmes :
- Mettre à jour le moyen de paiement
- Voir les factures
- Annuler l’abonnement
- Changer d’offre
// Request
{
return_url: "https://app.example.com/settings";
}
// Response
{
url: "https://billing.stripe.com/...";
}Identité d’Abonnement
Chaque compte possède une identité d’abonnement qui associe le compte au client Stripe. Elle sert à résoudre les webhooks et synchroniser l’état de facturation.
Événements Webhook
AM gère les webhooks Stripe et réessaie en cas d’échec :
| Événement | Action |
|---|---|
checkout.session.completed | Associer le client et créer l’abonnement |
customer.subscription.* | Synchroniser les données d’abonnement |
invoice.paid | Synchroniser la facture + accès |
invoice.payment_failed | Mettre à jour la fenêtre d’accès |