Gérer les forfaits eSIM récurrents

Utilisez un abonnement récurrent pour acheter des forfaits data selon un calendrier de facturation. Vous avez besoin de l'autorisation d'acheter un service eSIM, de fonds dans le portefeuille de l'organisation et d'un abonné pour la personne utilisant l'eSIM. La disponibilité dépend de l'offre et du profil sélectionnés.

Ce guide couvre les nouveaux achats et l'inscription sur une eSIM existante. L'eSIM API ne fournit pas d'opération pour basculer un abonnement actif vers un autre forfait.

1. Examiner les conditions récurrentes

Pour une nouvelle eSIM, obtenez les options de paiement. Proposez le renouvellement automatique lorsque recurrence.available est true et utilisez son quote pour les conditions acceptées. Si indisponible, inspectez unavailable_reason et proposez une option d'achat prise en charge.

Pour une eSIM existante, listez les offres compatibles avec recurring_only=true, puis obtenez les conditions récurrentes de l'offre sélectionnée. L'inscription vérifie à nouveau la compatibilité avant d'accepter l'achat.

Affichez le prix récurrent, la devise publiée, la cadence et le mode de livraison avant l'acceptation. Le montant indiqué est hors taxe ; l'historique des périodes enregistre le total facturé et la taxe. calendar_month suit les mois calendaires ; fixed_days utilise le nombre indiqué de jours de 24 heures. Le portefeuille de l'organisation paie le service ; l'abonné n'a pas de portefeuille distinct.

Vérifiez si le forfait couvre l'intervalle payé (exact_period) ou si chaque renouvellement achète un forfait standard (recurring_top_up). Avec les recharges récurrentes, l'activation et l'expiration suivent les conditions du forfait et peuvent différer des limites de facturation. Ne promettez pas une connectivité ininterrompue au seul motif qu'un renouvellement est planifié.

2. Attribuer l'abonné

Dans le tableau de bord, ouvrez le profil depuis eSIMs, ouvrez More eSIM actions, sélectionnez Assign person, choisissez le contact et confirmez Assign person. Vous ne pouvez pas changer la personne assignée par la suite.

Avec le API, créez un abonné en utilisant le contact_id d'un contact dans votre espace de travail. Cela nécessite email_marketing:read pour Contacts et esim:write. La réponse renvoie l'abonné existant lorsque le contact en possède déjà un.

La création de l'association empêche la suppression du contact, y compris après la fin de l'eSIM. Les associations d'abonnés ne peuvent actuellement pas être supprimées, détachées ou anonymisées. Déterminez si cette rétention convient à votre processus client avant d'en créer une.

Pour un profil existant, assignez l'eSIM en utilisant subscriber_id. Répéter la même assignation renvoie l'enregistrement existant ; assigner une personne différente renvoie 409. Pour un nouveau profil, incluez subscriber_id dans l'achat afin que l'assignation se termine avec la livraison.

L'assignation n'accorde ni l'accès à l'espace de travail ni l'autorisation de lire les identifiants d'installation. Gérez la collecte d'identité séparément à l'aide des prérequis de l'offre et du guide d'intégration.

3. Inscrire et vérifier la livraison

Pour une eSIM existante déjà assignée dans le tableau de bord, ouvrez Automatic renewal et sélectionnez Set up renewal. Choisissez un Package, sélectionnez Check recurring price, puis vérifiez le prix, la cadence et les conditions de livraison du forfait. Sélectionnez Buy first package and renew pour acheter la première période et activer le renouvellement.

Pour une nouvelle eSIM via le API, créez une commande avec l'offre sélectionnée offer_id, l'espace de travail subscriber_id, et les conditions de paiement acceptées suivantes :

• Définissez offer_revision sur recurrence.quote.offer_revision.
• Définissez recurrence.recurrence_revision sur recurrence.quote.recurrence_revision.
• Définissez recurrence.accepted_price sur l'objet recurrence.quote.price complet.

Envoyez un Idempotency-Key ; omettez esim_id et expected_price pour cet achat. Enregistrez l'identifiant de commande et son recurring_subscription_id. La première période de facturation commence lorsque le paiement est approvisionné. Suivez la commande jusqu'à ce qu'elle aboutisse ou échoue, en utilisant les étapes de récupération d'achat si nécessaire.

Pour une eSIM existante déjà assignée, créez un abonnement récurrent avec esim_id, offer_id, le revision de l'offre comme offer_revision, et le revision des conditions récurrentes comme recurrence_revision. Envoyez le price complet des conditions récurrentes comme accepted_price. Un Idempotency-Key est requis ; réutilisez-le avec la même requête pour récupérer l'inscription. L'inscription achète la première période immédiatement ; elle n'attend pas qu'un forfait existant soit épuisé.

Récupérez l'abonnement et listez ses périodes. Confirmez le paiement et la livraison du forfait séparément. Pour une nouvelle eSIM, transmettez les détails d'installation une fois sa commande terminée.

4. Surveiller le renouvellement

Ouvrez Subscriptions pour consulter les conditions acceptées, le statut et le prochain renouvellement. Dans le API, lisez next_renewal_at, stop_reason et l'historique des périodes. Un changement de prix publié nécessite une nouvelle acceptation ; un renouvellement non approvisionné arrête les achats futurs.

Si status est needs_attention, inspectez la dernière période et la commande associée. Une livraison non résolue peut rester payable et bloque une nouvelle inscription de remplacement. Contactez le support avec ces références avant d'acheter un remplacement.

5. Arrêter le renouvellement futur

Dans la section Automatic renewal de l'eSIM, sélectionnez Cancel renewal. Vérifiez la fin de la période payée en cours, puis confirmez Cancel renewal dans la boîte de dialogue. Consultez l'abonnement mis à jour pour sa date d'annulation.

Avec le API, annulez l'abonnement, puis relisez-le. Vérifiez cancel_at_period_end, cancellation_effective_at et next_renewal_at pour confirmer la date de fin de renouvellement. Une période déjà engagée reste payable. Les forfaits livrés conservent leur propre validité, et le profil installé est préservé.

Supprimer le profil du téléphone n'annule pas le renouvellement. Libérer une eSIM la retire définitivement, entraîne la perte des données restantes et n'ouvre droit à aucun remboursement. Utilisez les actions de service si vous souhaitez modifier la connectivité en plus du renouvellement.

Dépannage

Ajouter des fonds au portefeuille ne redémarre pas automatiquement un abonnement arrêté. Vérifiez stop_reason et l'état final du service précédent avant d'accepter un nouvel enrôlement. Un paiement abouti suivi d'une livraison échouée et son crédit ont des résultats distincts : inspectez order_status et refund_transaction_id dans l'historique des périodes.

Vérifier le parcours client

Confirmez que le client peut trouver l'enveloppe de données achetée, la date d'expiration du forfait, le prochain renouvellement, la date d'annulation et le contact du support. Vérifiez la livraison du premier forfait et testez les données mobiles sur un appareil compatible. Contrôlez le paiement et la livraison d'une période suivante indépendamment de sa date de renouvellement prévue.

Étapes suivantes

• Consulter les soldes et acheter une recharge ponctuelle.
• Préparer l'installation sur l'appareil.
• Investiguer les problèmes de paiement ou de livraison.