DocsTableau de bord

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.