Passer au contenu principal
POST
/
subscriptions
/
checkout
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/checkout \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "professional",
    "successUrl": "https://yourapp.com/subscription/success",
    "cancelUrl": "https://yourapp.com/pricing"
  }'

{
  "sessionId": "cs_test_a1b2c3d4e5f6g7h8i9j0",
  "url": "https://checkout.stripe.com/c/pay/cs_test_a1b2c3d4...",
  "plan": {
    "id": "professional",
    "name": "Professional",
    "monthlyCredits": 3000,
    "priceCents": 1299
  }
}

​
Vue d’ensemble

Crée une session Stripe Checkout pour souscrire à une formule. Renvoie une URL vers laquelle rediriger l’utilisateur pour finaliser le paiement. Nécessite une authentification par session (jeton d’accès JWT).
Pour les intégrations tierces : utilisez POST /subscriptions/checkout/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

​
planId
string
requis
Identifiant de la formule : starter, professional, business ou agency.
​
billingCycle
string
défaut:"monthly"
Fréquence de facturation : monthly ou yearly.
​
successUrl
string
URL de redirection après paiement réussi. Par défaut : tableau de bord de l’application.
​
cancelUrl
string
URL de redirection si l’utilisateur annule le paiement. Par défaut : page tarifs.
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/checkout \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "professional",
    "successUrl": "https://yourapp.com/subscription/success",
    "cancelUrl": "https://yourapp.com/pricing"
  }'

{
  "sessionId": "cs_test_a1b2c3d4e5f6g7h8i9j0",
  "url": "https://checkout.stripe.com/c/pay/cs_test_a1b2c3d4...",
  "plan": {
    "id": "professional",
    "name": "Professional",
    "monthlyCredits": 3000,
    "priceCents": 1299
  }
}

​
Champs de réponse

​
sessionId
string
Identifiant de session Stripe Checkout. Permet une vérification ultérieure.
​
url
string
URL de redirection vers la page de paiement hébergée par Stripe.
​
plan
object
Détails de la formule sélectionnée.

​
Déroulement du checkout

  1. Créer la session : appeler ce point de terminaison avec la formule souhaitée
  2. Rediriger l’utilisateur : envoyer vers l’url renvoyée
  3. Paiement : l’utilisateur paie sur Stripe
  4. Webhook : Stripe notifie votre endpoint webhook
  5. Redirection succès : l’utilisateur arrive sur successUrl
  6. Vérification (facultatif) : contrôler l’abonnement via /subscriptions/current

​
Réponses d’erreur

​
400
Requête incorrecte : identifiant de formule invalide ou abonnement déjà actif.
​
401
Non autorisé : jeton manquant ou invalide.
Si l’utilisateur a déjà un abonnement actif, il doit utiliser le portail de facturation (/subscriptions/portal) pour changer de formule.

​
POST /subscriptions/checkout/api

Crée une session Stripe Checkout 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/checkout ci-dessus.

​
Réponse

Identique à /subscriptions/checkout ci-dessus. 
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/checkout/api \
  -H "Authorization: Bearer llmgen_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "professional",
    "successUrl": "https://yourapp.com/subscription/success",
    "cancelUrl": "https://yourapp.com/pricing"
  }'