Comment configurer des produits par abonnement et des groupes de plans

Un produit par abonnement est un service ou un ensemble de services fournis à l’utilisateur lors de l’achat d’un abonnement. La création de produits par abonnement est nécessaire lorsque vous configurez la vente d’abonnements distincts pour différents services ou si vous souhaitez permettre à l’utilisateur de souscrire plusieurs abonnements en même temps. Un produit par abonnement peut représenter l’accès à une chaîne de streaming, à un jeu, à un objet ou une capacité unique.

Un groupe de plans est un ensemble de plans ayant la même valeur de paramètre group_id. Le paramètre group_id est utilisé pour former un groupe de plans et associer ce groupe à des produits par abonnement. La création d’un groupe de plans vous permet de :

• limiter le nombre de plans que l’utilisateur peut choisir pour souscrire à un produit ;
• permettre à l’utilisateur de passer à un autre plan au sein du groupe.

Les groupes, les plans et les produits interagissent les uns avec les autres conformément aux règles suivantes :

• Un plan ne peut appartenir qu’à un seul groupe.
• Un produit peut être créé sur la base d’un seul groupe.
• Un groupe peut être lié à plusieurs produits.

Pour créer un produit par abonnement et un groupe de plans, passez les paramètres suivants à l’appel API Créer un produit :

• name avec le nom du produit ;
• group_id avec le nom du groupe de plans.

Pour modifier, supprimer ou obtenir la liste de tous les produits, utilisez les appels API correspondants :

• Mettre à jour un produit
• Supprimer un produit

• Lire les produits

Pour lier un plan à un groupe de plans et à un produit, passez le paramètre group_id avec le nom du groupe de plans à l’appel API Mettre à jour un plan. Pour supprimer un groupe, passez “group_id”:null.

Pour ouvrir l’interface de paiement lors de l’achat d’un plan lié à un produit, passez les paramètres suivants à l’appel API Créer un jeton :

• purchase.subscription.plan_id avec l’ID du plan ;

• purchase.subscription.product_id avec l’ID du produit associé au plan via group_id.

Exemples

• Si vous souhaitez vendre l’accès au jeu avec une seule option d’abonnement, vous devez configurer un plan d’abonnement, mais vous n’avez pas besoin de configurer de produit.
• Si vous souhaitez vendre l’accès au jeu pour des conditions différentes, par exemple pour un ou trois mois, vous devez configurer deux plans d’abonnement correspondant à ces conditions. Il n’est pas non plus nécessaire de configurer le produit. Les plans auront le paramètre “group_id”:null par défaut, c’est-à-dire qu’ils appartiendront au groupe général. L’utilisateur pourra choisir l’une des options lors de l’achat de l’abonnement, ainsi que passer d’un plan à l’autre.
• Si vous souhaitez vendre non seulement l’accès au jeu pour 1 et 3 mois, mais également un abonnement supplémentaire, par exemple une mise à niveau d’épée pour 6 mois, dans ce cas :
  1. Créez 2 produits « jeu » et « épée» en passant des paramètres name et group_id uniques pour chaque produit à l’appel API Créer un produit.
  2. Créez des plans pour 1, 3 ou 6 mois en procédant de l’une des manières suivantes :
     • Configurez les plans dans le Compte éditeur, puis utilisez l’appel API Mettre à jour un plan pour passer le paramètre group_id du produit « jeu » aux plans d’abonnement pour la vente du jeu et le paramètre group_id du produit « épée » aux plans d’abonnement pour la vente de l’épée ;
     • Utilisez l’appel API Créer un plan, dans lequel vous passez les données relatives aux plans, ainsi que le paramètre group_id du produit « jeu » aux plans d’abonnement pour la vente du jeu, et le paramètre group_id du produit « épée » aux plans d’abonnement pour la vente de l’épée.
  3. Implémentez l’affichage des produits « abonnement au jeu » et « abonnement à l’épée mis à niveau » dans l’interface du magasin.

Dernière mise à jour: 22 Janvier 2024