Skip to main content

​
Vue d’ensemble

Les abonnements vous permettent de prélever plusieurs fois la même carte d’un client, sans lui demander de la saisir à nouveau. Le client enregistre sa carte une seule fois, donne un consentement explicite et s’authentifie avec 3D Secure. HUB2 conserve ensuite une référence de la carte, jamais le numéro de carte, et l’utilise pour chaque prélèvement suivant. Ce mécanisme s’appelle le card-on-file. L’enregistrement de la carte ne débite pas le client. Le premier prélèvement a lieu à la date de début que vous définissez pour un abonnement planifié, ou au moment où vous le demandez pour un abonnement à la demande.

​
Deux types d’abonnement

Vous choisissez le type d’abonnement lors de l’inscription du client. Le type correspond au champ billingMode de l’abonnement et ne peut pas être modifié par la suite.

​
Fonctionnement

  1. Créez une clé API avec les permissions d’abonnement.
  2. Demandez à HUB2 d’activer le card-on-file pour votre compte marchand.
  3. Inscrivez le client, soit en envoyant un lien d’abonnement, soit en démarrant une intention d’abonnement depuis votre propre page.
  4. Suivez l’inscription avec le webhook subscription.created ou en interrogeant le statut de l’inscription.
  5. Laissez HUB2 prélever le client (abonnement planifié), ou débitez le client quand vous en avez besoin (abonnement à la demande).
  6. Gérez l’abonnement : listez, suspendez, résiliez et consultez les débits.

​
Deux façons d’inscrire un client

  • Lien d’abonnement : un seul appel API retourne un lien vers une page hébergée par HUB2. Vous partagez le lien par e-mail, par SMS ou dans votre application. La page recueille l’adresse e-mail et le consentement du client, puis l’envoie vers la page de saisie de la carte. Vous ne développez aucune interface.
  • Intention d’abonnement : vous recueillez le consentement dans votre propre interface et démarrez l’inscription par l’API. HUB2 retourne l’action à effectuer pour ouvrir la page de saisie de la carte. Vous maîtrisez tout le parcours client et vous pouvez créer des abonnements à la demande.

​
Points clés

  • Consentement explicite : aucune inscription ne démarre sans un consentement donné par le client et horodaté.
  • 3D Secure : chaque inscription est authentifiée par l’émetteur de la carte.
  • Aucune donnée de carte chez vous : HUB2 conserve la référence de la carte. Vous ne manipulez que l’identifiant de l’abonnement.
  • La résiliation est définitive : un abonnement résilié arrête tous les prélèvements futurs. HUB2 ne rembourse ni ne calcule de prorata lors d’une résiliation.
  • Notifications : HUB2 envoie des e-mails au client pour l’inscription, les prélèvements à venir, les prélèvements réussis et échoués, ainsi que lorsqu’un abonnement est suspendu ou résilié.

​
Disponibilité

Le card-on-file est disponible pour les marchands enregistrés en Côte d’Ivoire, et il doit être activé sur votre compte marchand par HUB2. Tant que ce n’est pas le cas, les demandes d’inscription sont refusées avec une erreur 403. Contactez le support HUB2 pour en faire la demande.

​
Cas d’usage

Les abonnements sont idéaux pour :
  • Les opérateurs de télécommunications et d’accès internet : prélever la mensualité d’une offre sans envoyer de demande de paiement chaque mois.
  • Les compagnies d’assurance : collecter les primes chaque semaine ou chaque mois.
  • Les salles de sport, les écoles et les associations : facturer les adhésions et les échéances de scolarité selon un calendrier fixe.
  • Les places de marché et les services publics : enregistrer la carte une fois, puis débiter chaque facture lorsque son montant est connu.