Cas d'usage de planifications d'abonnements

Pour comprendre comment fonctionnent les planifications pour les abonnements, prenons l’exemple d’un acteur fictif de la presse nommé The Pacific, qui propose deux options d’abonnement :

• L’option Print, qui abonne le client à la version papier du journal
• L’option Digital, qui donne accès au contenu exclusif du site web de The Pacific

Les deux types d’abonnement déclenchent une facturation mensuelle. Découvrez ci-après les possibilités de planification qui s’offrent au journal.

Démarrer un abonnement à une date future

Par défaut, les nouveaux abonnements à la version papier commencent le premier jour du mois suivant. Pour ce faire, la start_date est définie sur une date future. Le code ci-dessous crée un abonnement qui débute dans le futur :

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=1690873200 \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"={{PRICE_PRINT}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=12

Antidater un abonnement

Lorsque les clients s’abonnent à la version numérique, leur abonnement est antidaté par The Pacific au premier jour du mois en cours. L’utilisation de l’antidatage a pour but de facturer au prorata du temps passé et permet aux abonnés numériques d’accéder directement au site Web.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=1688194800 \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"={{PRICE_DIGITAL}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=12

Ajouter une planification à un abonnement existant

The Pacific peut s’apercevoir que certains de ses clients d’origine sont abonnés sans planification. Puisque ces abonnements existent déjà, les ID d’abonnement peuvent être transmis à l’attribut from_subscription pour leur ajouter une planification. La transmission des ID d’abonnement de cette façon crée une planification qui comporte une phase unique basée sur la période de facturation actuelle de l’abonnement.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d from_subscription=
{{SUBSCRIPTION_ID}}

Lors de l’ajout de ces planifications, certains clients décident de s’abonner à la version imprimée. The Pacific ajoute alors une seconde phase à la planification pour faire débuter cet abonnement papier un mois plus tard. Le cas d’usage ci-après illustre ce processus.

Passer à des abonnements supérieurs

The Pacific offre la possibilité de débuter avec un abonnement papier pendant un mois, puis d’y ajouter ensuite automatiquement l’option numérique. Certains clients préfèrent cette approche car elle leur permet dans un premier temps de tester les publications papier, avant d’arrêter leur choix de poursuivre ou d’annuler leur abonnement.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"={{PRICE_PRINT}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=1 \
  -d "phases[1][items][0][price]"={{PRICE_PRINT}} \
  -d "phases[1][items][0][quantity]"=1 \
  -d "phases[1][items][1][price]"={{PRICE_DIGITAL}} \
  -d "phases[1][items][1][quantity]"=1 \
  -d "phases[1][iterations]"=11

Revenir à des abonnements inférieurs

The Pacific propose par ailleurs une option qui permet de profiter initialement des deux types de publication, imprimées et numériques, avant de rebasculer automatiquement sur un abonnement papier uniquement. Les clients utilisent cette option pour tester les deux possibilités et identifier ce qui leur convient le mieux.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"={{PRICE_DIGITAL}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][items][1][price]"={{PRICE_PRINT}} \
  -d "phases[0][items][1][quantity]"=1 \
  -d "phases[0][iterations]"=1 \
  -d "phases[1][items][0][price]"={{PRICE_PRINT}} \
  -d "phases[1][items][0][quantity]"=1 \
  -d "phases[1][iterations]"=11

Modifier des abonnements

The Pacific propose deux options d’abonnement papier : une option de base avec publicités et une option premium sans publicités. Certains clients abonnés à l’option premium décident de passer à l’option de base lors du prochain cycle de facturation. Créez une planification pour l’abonnement existant, puis modifiez-la en spécifiant une nouvelle phase définie sur l’option de base.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

# Create a subscription schedule with the existing subscription
schedule = Stripe::SubscriptionSchedule.create({
  from_subscription: 'sub_ERf72J8Sc7qx7D',
})

# Update the schedule with the new phase
Stripe::SubscriptionSchedule.update(
  schedule.id,
  {
    phases: [
      {
        items: [
          {
            price: schedule.phases[0].items[0].price,
            quantity: schedule.phases[0].items[0].quantity,
          },
        ],
        start_date: schedule.phases[0].start_date,
        end_date: schedule.phases[0].end_date,
      },
      {
        items: [
          {
            price: '{{PRICE_PRINT_BASIC}}',
            quantity: 1,
          },
        ],
        iterations: 1,
      },
    ],
  },
)

Augmenter la quantité

Il est également possible de planifier des augmentations de quantité sur un abonnement. L’abonnement ci-dessous débute avec une instance de la publication numérique sur un mois. Au cours de la seconde phase, la quantité est portée à 2 pendant 11 mois supplémentaires.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=1 \
  -d "phases[1][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[1][items][0][quantity]"=2 \
  -d "phases[1][iterations]"=11

Utiliser des bons de réduction

Parfois, The Pacific propose des offres spéciales d’abonnement. La planification ci-dessous propose au client une réduction de 50 % sur les publications papier pendant six mois. La planification retire ensuite le bon de réduction de l’abonnement à l’ouverture de la seconde phase, qui couvre les six mois restants.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=6 \
  -d "phases[0][discounts][0][coupon]"=
{{COUPON_ID}} \
  -d "phases[1][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[1][items][0][quantity]"=1 \
  -d "phases[1][iterations]"=6

Modifier les taux de taxe

The Pacific est présent dans plusieurs juridictions, et certaines d’entre elles appliquent des taux d’imposition uniques pour les entreprises qui proposent des abonnements. Une de ces juridictions prévoit deux taux d’imposition : un pour le premier mois lorsque le client s’abonne initialement et un autre pour les facturations récurrentes.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][items][0][tax_rates][0]"=txr_2J8lmBBGHJYyuUJqF6QJtaAA \
  -d "phases[0][iterations]"=1 \
  -d "phases[1][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[1][items][0][quantity]"=1 \
  -d "phases[1][items][0][tax_rates][0]"=txr_2J8lmBBGHJYyuUJqF6QJtbBB \
  -d "phases[1][iterations]"=11

Libérer un abonnement d’une planification

Vous pouvez libérer un abonnement d’une planification tant que celle-ci est à l’état not_started ou active. Lorsque vous libérez un abonnement, il reste effectif, mais la planification et toutes les phases restantes définies sont supprimées.

curl -X POST https://api.stripe.com/v1/subscription_schedules/
{{SUBSCRIPTION_SCHEDULE_ID}}
/release \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Annuler une planification et un abonnement

Vous pouvez immédiatement annuler une planification d’abonnement et les abonnements associés (à condition que la planification d’abonnement comporte un abonnement actif). Une planification d’abonnement ne peut être annulée que si son état est not_started ou active.

curl -X POST https://api.stripe.com/v1/subscription_schedules/
{{SUBSCRIPTION_SCHEDULE_ID}}
/cancel \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Réinitialiser la date de début du cycle de facturation

The Pacific facture les clients de longue date de ses publications papier le jour du mois où ils se sont initialement abonnés. Cette date correspond à la date de début du cycle de facturation du client.

Si ces clients font le choix de passer à l’édition numérique, The Pacific planifie leur date de transition au premier jour du mois suivant, et réinitialise également la date de début du cycle de facturation à la même date.

Vous pouvez vérifier que la date de début du cycle de facturation est réinitialisée en créant un abonnement à l’aide de l’exemple de code ci-dessous. Examinez l’abonnement dans le Dashboard et notez que la Facture à venir est planifiée pour facturer le client dès que l’abonnement numérique prend effet le 1er.

Pour voir ce qu’il se passera si vous ne réinitialisez pas la date de début, exécutez à nouveau l’exemple de code, mais supprimez cette fois-ci la ligne qui définit la date de début du cycle de facturation sur phase_start. Sans cette ligne, la fonction Facture à venir du Dashboard attendra un mois complet, à compter de la date du jour, avant de facturer le client et ce, malgré la transition en date du 1er.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d "phases[0][items][0][price]"={{PRICE_PRINT}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][end_date]"=1690873200 \
  -d "phases[1][items][0][price]"={{PRICE_DIGITAL}} \
  -d "phases[1][items][0][quantity]"=1 \
  -d "phases[1][iterations]"=11 \
  -d "phases[1][billing_cycle_anchor]"=phase_start

Plans de versements échelonnés

Les plans de paiement échelonné permettent aux clients d’effectuer des paiements partiels sur une période déterminée jusqu’à ce que le montant total ait été acquitté. Par exemple, lorsque The Pacific achète de nouvelles presses, elle vend ses anciennes presses à d’autres journaux. Les petits journaux ne disposant généralement pas des fonds suffisants pour régler en une seule fois, un plan de paiement échelonné leur est proposé.

Pour la plupart des presses, The Pacific facture 1 000 € par mois. Un tarif réutilisable est par conséquent créé :

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d unit_amount=100000 \
  -d currency=usd \
  -d product=prod_Hh99apo1OViyGW \
  -d "recurring[interval]"=month

Selon la marque, le modèle et l’âge de la presse, The Pacific facture des montants différents. Dans cet exemple, 1 000 USD sont facturés mensuellement pendant six mois, pour un montant total est de 6 000 USD.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=cancel \
  -d "phases[0][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=6

Le nombre d’iterations est multiplié par la période du tarif, qui est égale à 6 paiements mensuels dans cet exemple, pour déterminer le nombre de facturations. Le end_behavior détermine ce qu’il advient de l’abonnement au terme de la dernière itération. Dans un plan de paiement échelonné, l’abonnement n’est alors plus pertinent, et le end_behavior est donc défini sur cancel.

Dans des cas plus rares, The Pacific facture moins que les 1 000 USD habituels par mois. Dans ce cas-là, le service comptable utilise price_data pour créer un tarif à usage unique. Cet exemple crée un tarif de 500 USD avec facturation mensuelle pendant six mois :

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=cancel \
  -d "phases[0][items][0][price_data][currency]"=usd \
  -d "phases[0][items][0][price_data][product]"=prod_Hh99apo1OViyGW \
  -d "phases[0][items][0][price_data][recurring][interval]"=month \
  -d "phases[0][items][0][price_data][unit_amount]"=50000 \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=6