Allo

Obtenir le prix d'un compte

Renvoie ce qu'Allo vous facturera pour un nouveau compte selon la périodicité choisie, avec votre remise partenaire appliquée. Appelez-le avant Créer un…

GET/v2/api/partner/accounts/price

Renvoie ce qu'Allo vous facturera pour un nouveau compte selon la périodicité choisie, avec votre remise partenaire appliquée. Appelez-le avant Créer un compte pour afficher ou vérifier le prix.

  • interval est requis : MONTHLY ou YEARLY.
  • Les montants sont exprimés dans la plus petite unité de votre devise de facturation (centimes pour l'EUR et l'USD). currency_code est en minuscules, ex. eur.
  • product_price est débité en totalité à la création du compte. Il n'y a pas de prorata : product_prorated_price renvoie donc le même montant. pay_now est déprécié et renvoie aussi le même montant.
  • pay_next_period est le coût du prochain renouvellement. Il est égal à product_price quand votre remise s'applique au-delà de la première facture, et au prix plein du plan sinon.
  • is_trial vaut toujours false et reason vaut toujours NEW_SEAT : un compte partenaire ne démarre jamais en essai.
  • Si votre compte n'est pas un partenaire activé, la requête échoue avec PARTNER_ACCESS_REQUIRED. Si votre contrat partenaire ne permet pas de créer des comptes, elle échoue avec PARTNER_CONTRACT_CANNOT_PROVISION.

Autorisation

Authorizationstring · headerrequis

Api-Key ak_live_…

Paramètres de requête

intervalenum<string>requis

Billing interval of the account you want to price.

MONTHLYYEARLY

Réponses

200Price of a new account
dataobject
4 champs
pricingobject
5 champs
product_priceinteger<int64>

Price charged when the account is created, partner discount applied, in the smallest currency unit.

product_prorated_priceinteger<int64>

Same as product_price: a partner account is charged in full, with no proration.

pay_next_periodinteger<int64>

Price of the next renewal. Equals product_price when your discount applies beyond the first invoice, otherwise the full plan price.

currency_codestring

Lowercase ISO 4217 code of your billing currency.

pay_nowinteger<int64>

Deprecated. Use product_prorated_price.

intervalenum<string>

MONTHLYYEARLY

is_trialboolean

Always false: a partner account never starts on a trial.

reasonenum<string>

Always NEW_SEAT for a partner account.

NEW_SEAT

400
401
403The API key lacks the PARTNER scope, your account is not an enabled partner (PARTNER_ACCESS_REQUIRED), or your partner contract cannot create accounts (PARTNER_CONTRACT_CANNOT_PROVISION).
errorobject
429