DocsTableau de bord

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"obligatoire
interval"month" | "year"obligatoire
interval_countinteger
unit_minorstring
Prix par unité, en centimes.
tiersliste de object
tier_mode"graduated" | "volume"
graduated : chaque palier à son prix ; volume : toutes les unités au prix du palier atteint.
trial_daysinteger
unit_labelstring, 0 à 40
tax_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.