Abonnements
Créer un plan
POST/v1/planspayments:write
Needs payments:write. A new plan is a draft with its first price.
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- Optional. The same key with the same request returns the same plan and creates nothing more; the same key with another request: 409 idempotency_conflict. 1 to 128 visible ASCII characters (400 invalid_idempotency_key otherwise). Keys never mix between spaces.
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.