DocsTableau de bord

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_idstringobligatoire
customerobjectobligatoire
Le nom et l’e-mail de l’acheteur, facultatifs : vous le retrouvez dans le tableau de bord (liste, recherche, fiche, export).
quantityinteger
time_zonestring
Le fuseau horaire des échéances.
discount_bpinteger
discount_cyclesinteger ou null
test_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.