Abonnements
Ajouter un prix
POST/v1/plans/{id}/pricespayments:write
Autorisation payments:write. Ajoute un prix pour les nouveaux abonnements. Un prix n’est jamais réécrit : les abonnés gardent le leur.
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
model"fixed" | "tiered" | "usage"obligatoireinterval"month" | "year"obligatoireinterval_countintegerunit_minorstring- Prix par unité, en centimes.
tiersliste de objecttier_mode"graduated" | "volume"- graduated : chaque palier à son prix ; volume : toutes les unités au prix du palier atteint.
trial_daysintegerunit_labelstring, 0 à 40tax_bpinteger- Taux de TVA en points de base (20 % = 2000) ; les prix sont hors taxe.
currencystring- Code de la devise sur 3 lettres (EUR, USD…).
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.