Abonnements
Ouvrir la caisse d’un abonnement
POST/v1/subscriptions/{id}/checkout-sessionpayments:write
Autorisation payments:write. Ouvre la caisse pour la première facture due. L’acheteur y accepte les renouvellements puis paie ; sa carte paie ensuite les échéances sans lui. Pendant un essai sans carte, la caisse enregistre la carte sans rien débiter ; la fin de l’essai est prélevée dessus. Sans rien de dû, la même caisse sert à changer de carte : l’abonné enregistre une nouvelle carte, rien n’est débité, et elle paie les échéances suivantes à la place de l’ancienne. La carte en place se lit sur l’abonnement : payment_method.card (marque, 4 derniers chiffres, expiration). Le compte doit pouvoir garder une carte (Stripe) : sinon 409 capability_unsupported.
En-têtes
AuthorizationBearer pos_key_…obligatoire- Clé de serveur, pour tout l’espace. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire- L’espace marchand concerné (mrc_…).
Paramètres
iddans le cheminobligatoire
Corps
return_urlstring, 0 à 2048- La page de votre boutique où revient l’acheteur. Même origine qu’une de vos adresses de notification, en https.
Réponses
- 201Créé
- 400Requête invalide
- 401Clé absente ou invalide
- 402Service restreint
- 403Autorisation ou espace refusé
- 404Ressource introuvable
- 409Conflit avec une demande existante
- 429Trop de demandes, réessayez plus tard
- 503Service momentanément indisponible
Une erreur ne vaut jamais paiement. Le corps donne code, message, request_id et retry_action ; renvoyez la même Idempotency-Key si retry_action le propose.