Passer au contenu principal
POST
/
subscriptions
/
portal
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/portal \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/settings/billing"
  }'

{
  "url": "https://billing.stripe.com/p/session/test_a1b2c3d4..."
}

​
Vue d’ensemble

Crée une session du portail client Stripe où l’utilisateur peut :
  • mettre à jour ses moyens de paiement
  • consulter l’historique de facturation
  • modifier sa formule d’abonnement
  • télécharger les factures
  • résilier son abonnement
Nécessite une authentification par session (jeton d’accès JWT).
Pour les intégrations tierces : utilisez POST /subscriptions/portal/api avec authentification par clé d’API.

​
Authentification

​
Authorization
string
requis
Jeton d’accès JWT. Format : Bearer YOUR_ACCESS_TOKEN

​
Corps de la requête

​
returnUrl
string
URL de retour à la sortie du portail. Par défaut : tableau de bord de l’application.
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/portal \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/settings/billing"
  }'

{
  "url": "https://billing.stripe.com/p/session/test_a1b2c3d4..."
}

​
Champs de réponse

​
url
string
URL de redirection vers le portail de facturation hébergé par Stripe.

​
Fonctionnalités du portail

Le portail client Stripe permet notamment :
FonctionnalitéDescription
Moyens de paiementAjouter, mettre à jour ou supprimer des cartes
FacturesConsulter et télécharger les factures passées
Changement de formulePasser à une offre supérieure ou inférieure
RésiliationRésilier l’abonnement
HistoriqueVoir toutes les transactions

​
Réponses d’erreur

​
400
Requête incorrecte : aucun compte de facturation trouvé. Un achat préalable est nécessaire.
​
401
Non autorisé : jeton manquant ou invalide.
Le portail n’est disponible que pour les utilisateurs ayant déjà effectué un achat ou disposant d’un abonnement actif. Les nouveaux utilisateurs doivent passer par le checkout.

​
POST /subscriptions/portal/api

Crée une session du portail client Stripe avec authentification par clé d’API. Adapté aux intégrations tierces.

​
Authentification

Authentification par clé d’API obligatoire. Indiquez votre clé dans l’en-tête Authorization : 
Authorization: Bearer llmgen_your_api_key_here

​
Corps de la requête

Identique à /subscriptions/portal ci-dessus.

​
Réponse

Identique à /subscriptions/portal ci-dessus. 
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/portal/api \
  -H "Authorization: Bearer llmgen_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/settings/billing"
  }'

​
Bonnes pratiques

  • Lien dans les paramètres : ajouter un bouton « Gérer la facturation » dans les réglages
  • Après le checkout : proposer le portail juste après un achat
  • Support : offrir un accès en libre-service pour les questions de facturation