Abonnements
Créer un plan
POST/v1/planspayments:write
Autorisation payments:write. Crée un plan en brouillon avec son premier prix. Il s’ouvre aux abonnements avec POST /v1/plans/{id}/publish. interval_count fixe la durée payée d’avance puis renouvelée : 3 avec month facture tous les 3 mois (1 à 36 mois, 1 à 3 ans, 1 par défaut).
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_…).
Idempotency-Keystring- La même clé avec la même demande retrouve la première réponse ; avec une autre demande : 409.
Corps
namestring, 0 à 80obligatoiredescriptionstring, 0 à 200pricePlanPriceobligatoire
Réponses
- 200Réussi
- 400Requête invalide
- 401Clé absente ou invalide
- 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.