Abonnements avec plusieurs produits

Créez des abonnements avec plusieurs produits tous facturés sur la même facture.

Si vous proposez plusieurs produits ou que vous voulez facturer des montants différents pour le même produit, vous pouvez lier plusieurs produits à un abonnement. Il en résulte une seule facture par période de facturation combinant tous les tarifs. Un seul paiement pour cette facture est requis, ce qui réduit vos coûts ainsi que le nombre de paiements visibles par votre client.

Créer des abonnements comportant plusieurs produits

Créez des abonnements pour plusieurs produits pour un client à l’aide du paramètre items. Fournissez les informations price et, facultativement, quantity (lorsque vous utilisez une valeur différente de 1) de chaque produit :

La liste de tous les tarifs, quantités et postes d’abonnement est incluse dans la réponse :

{
  "id": "sub_CZEpS1Zt9QLxdo",
  "object": "subscription",
  ...
  "items": {
    "object": "list",
    "data": [
      {
        "id": "si_H1yPnAVzP9vDRW",
        "object": "subscription_item",
        "billing_thresholds": null,
        "created": 1585939321,
        "metadata": {
        },
        "price": {
          "id": "price_H1c8v1liEvrfcd",
          "object": "price",
          "active": true,
          "billing_scheme": "per_unit",
          "created": 1585856460,
          "currency": "usd",
          "livemode": false,
          "lookup_key": null,
          "metadata": {
          },
          "nickname": null,
          "product": "prod_H1c7exjJHbC4sr",
          "recurring": {
            "interval": "month",
            "interval_count": 1,
            "trial_period_days": null,
            "usage_type": "licensed"
          },
          "tiers": null,
          "tiers_mode": null,
          "transform_quantity": null,
          "type": "recurring",
          "unit_amount": 1000,
          "unit_amount_decimal": "1000"
        },
        "quantity": 1,
        "subscription": "sub_H1yPRslJXa4TUt",
        "tax_rates": [
        ]
      },

Périodes de facturation avec différents tarifs

Les tarifs conventionnels qui appliquent un montant fixe pour un intervalle de temps spécifique sont facturés au début de chaque cycle de facturation. À chaque facture, le client s’acquitte du paiement correspondant à la prochaine période de service. Avec la facturation à l’usage, le montant payé par le client varie selon sa consommation pendant le cycle de facturation. Le client doit donc payer à la fin du cycle de facturation.

Quand un abonnement combine un taux fixe à la facturation à l’usage, l’utilisation calculée du précédent cycle de facturation est facturée en même temps que le taux fixe du nouveau cycle, au début de chaque période de facturation. La facturation à l’usage et le taux fixe sont combinés sur une seule facture.

Restrictions

Comme l’utilisation de plusieurs produits dans le cadre d’un abonnement donne lieu à une seule facture et un seul paiement, tous les tarifs de ces produits doivent utiliser la même devise et respecter le même période de facturation. De plus, vous êtes limité à 20 produits par abonnement.

Réductions, taxes et périodes d’essai

En cas d’utilisation de plusieurs produits, vous pouvez également créer des réductions, imputer des taxes et utiliser des périodes d’essai comme vous le feriez pour un abonnement à un seul produit. Fournissez-les comme arguments de premier niveau à l’appel de création ou de mise à jour de l’abonnement, car ils s’appliquent à l’abonnement dans son ensemble :

Si vous créez un abonnement en transmettant des tarifs dans l’attribut items, toute période d’essai spécifiée au niveau des tarifs individuels sera ignorée. La période d’essai n’est respectée que si vous créez un abonnement avec un tarif unique à l’aide de l’attribut « legacy plan » (offre antérieure).

Plusieurs abonnements pour un client

Vous pouvez créer simultanément plusieurs abonnements pour un même client. Cette fonctionnalité est utile lorsque vous souhaitez permettre à vos clients de s’abonner à plusieurs produits avec des cycles distincts. Chaque abonnement a son propre cycle de facturation, sa propre facture et ses propres paiements, même si les tarifs sous-jacents ont la même période de facturation.

Créez plusieurs abonnements pour un client avec le même code de création d’abonnement :

Un client peut être abonné à plusieurs produits et également plusieurs fois au même produit. Chaque abonnement est associé à un ID unique et son état est géré indépendamment des autres abonnements du client. Chaque abonnement possède également son cycle de facturation indépendant, établi selon la date de début du cycle de facturation de l’abonnement.

Quand un client possède plusieurs abonnements, la propriété subscriptions de l’objet Customer fournit la liste de ses différents abonnements :

{
  "id": "cus_4fdAW5ftNQow1a",
  "object": "customer",
  "subscriptions": {
    "object": "list",
    "data": [
      {
        "id": "sub_9RRl3XywPg2P5H",
        "object": "subscription",
        ...
        "price": {
          "id": "price_CZB2krKbBDOkTS",
          "object": "price",
          "amount": 2995,
          ...
        }
      },
      {
        "id": "sub_9RRlIq2t9obFLI",
        "object": "subscription",
        ...
        "price": {
          "id": "price_CZB1AX3KOacNJw",
          "object": "price",
          "amount": 1295,
          ...
        }
      }
    ]
    ...
  }
  ...
}