Abonnements
Abonner un acheteur
POST/v1/subscriptionspayments:write
Autorisation payments:write. Abonne un acheteur au prix actuel d’un plan publié. Sans période d’essai, la première facture part tout de suite pour un prix payé d’avance ; l’usage se facture à la fin de sa période.
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
plan_idstringobligatoirecustomerobjectobligatoire- Le nom et l’e-mail de l’acheteur, facultatifs : vous le retrouvez dans le tableau de bord (liste, recherche, fiche, export).
quantityintegertime_zonestring- Le fuseau horaire des échéances.
discount_bpintegerdiscount_cyclesinteger ou nulltest_clockstring ou null
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.