Spécifier les détails du forfait avec frais uniquement

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

Introduction

Avec un forfait payant uniquement, le développeur ne paie que les frais du fournisseur d'API spécifiés dans le plan tarifaire (frais de configuration uniques ou de résiliation anticipée, par exemple). Pour savoir comment spécifier les frais dans le plan tarifaire, consultez l'article Ajouter des frais à un plan tarifaire. Aucuns frais supplémentaires liés aux transactions ne sont facturés.

Lorsque vous créez le forfait, vous pouvez éventuellement spécifier des conditions de renouvellement, c'est-à-dire la période de renouvellement. La monétisation renouvelle automatiquement le forfait à la fin de la période de renouvellement (sauf si le développeur résilie le forfait). Si le développeur résilie un plan tarifaire avant la date de renouvellement et que des frais de résiliation anticipée sont en vigueur, ces frais seront facturés à ce développeur.

Boîte à outils

Vous pouvez ajouter les détails du forfait uniquement à l'aide de l'API monetization. Pour ce faire, définissez les propriétés pertinentes dans le corps de la requête lors d'un appel à la ressource /organizations/{org_name}/monetization-packages/{package_id}/rate-plans (lorsque vous créez le plan tarifaire).

Spécifier les détails du forfait uniquement à l'aide de l'API

Vous spécifiez les détails du forfait uniquement lorsque vous créez le plan tarifaire. Vous devez spécifier les détails dans le corps de la requête de l'appel.

Par exemple, la requête suivante permet de créer un plan tarifaire avec des frais uniquement. Ce forfait spécifie des frais de résiliation anticipée (20 USD), des frais de configuration (10 dollars américains) et des frais récurrents (5 dollars américains par mois). Les frais doivent être réglés dans un délai de 30 jours, et les frais récurrents sont dus en totalité (c'est-à-dire qui ne sont pas calculés au prorata). La durée de renouvellement est de six mois. Les spécifications relatives aux frais et aux conditions de renouvellement sont mises en évidence.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
     "name": "Standard fees only plan",
     "advance": "false",
     "contractDuration": "6",
     "contractDurationType": "MONTH",
      "currency": {
      "id" : "usd"
     },
     "earlyTerminationFee": "20",
     "description": "Standard fees only plan",
     "displayName": "Standard fees only plan",
     "frequencyDuration": 1,
     "frequencyDurationType": "MONTH",
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "prorate": "false",
     "paymentDueDays": "30",
     "published": "true",  
     "ratePlanDetails": [],   
     "recurringFee": "5",
     "setUpFee": "10",
     "startDate": "2013-09-15 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans"  \
-u email:password

Notez que la propriété ratePlanDetails est vide. Pour un forfait payant uniquement, vous n'avez aucune information supplémentaire à fournir au-delà des frais et de la période de renouvellement.

La réponse devrait se présenter comme suit (seule une partie de la réponse est affichée) :
{
  "advance" : false,
  "contractDuration" : 6,
  "contractDurationType" : "MONTH",
  "currency" : {    
    "id" : "usd",
    "name" : "USD",
    ...
    "organization" : {
      ...
    },
    ...
  },
  "description" : "Standard fees only plan",
  "displayName" : "Standard fees only plan",
  "earlyTerminationFee" : 20,
  "freemiumDuration" : 0,
  "freemiumDurationType" : "MONTH",
  "freemiumUnit" : 0,
  "frequencyDuration" : 1,
  "frequencyDurationType" : "MONTH",
  "id" : "location_standard_fees_only_plan",
  "monetizationPackage" : {
    "description" : "Location",
    "displayName" : "Location",
    "id" : "location",
    "name" : "Location",
    "organization" : {
      ...
    },
    "product" : [ {
      "customAtt1Name" : "user",
      "description" : "Location",
      "displayName" : "Location",
      "id" : "location",
      "name" : "location",
      "organization" : {
        ...
    "status" : "CREATED"
  },
  "name" : "Standard fees only plan",
  "organization" : {
    ...
  },
  "paymentDueDays" : "30",
  "prorate" : false,
  "published" : false,
  "ratePlanDetails" : [ ],
  "recurringFee" : 5,
  "recurringStartUnit" : 1,
  "recurringType" : "CALENDAR",
  "setUpFee" : 10,
  "startDate" : "2013-07-30 00:00:00",
  "type" : "STANDARD"
}

Pour obtenir la liste complète des plans tarifaires, consultez la section Paramètres de configuration du plan tarifaire.

Étapes suivantes

Si vous le souhaitez, ajoutez un forfait freemium. Pour en savoir plus, consultez Ajouter un forfait freemium.

Après avoir créé le plan tarifaire et fourni ses détails, vous pouvez le publier ou l'enregistrer en tant que brouillon. Pour en savoir plus, consultez Gérer et publier des plans tarifaires.