Aller au contenu
ProAbonoProAbonoProAbono Docs

Souscription à un abonnement spécifique

Contexte

Section titled “Contexte”

C’est le cas standard qui permet à un client de souscrire au service directement vers une offre payante.

Lorsqu’un client potentiel clique sur l’offre de son choix depuis la page de présentation des offres, le client est redirigé vers le parcours de souscription.

Permet de créer un client ainsi qu’un abonnement basé sur une offre payante présentée dans le portail de présentation des offres.

Le formulaire de création de compte sur votre application et est redirigé dans le parcours de souscription de ProAbono pour finaliser sa souscription.

Prérequis

Section titled “Prérequis”

Pour que cela fonctionne, vous devez au préalable avoir réalisé les actions suivantes :

  • Modéliser vos offres dans votre environnement ProAbono.
  • Sélectionner les offres et les positionner dans une grille d’offre visible.
    • Créer et configurer dans votre application une page qui intègre l’iframe du portail client.
  • Votre application doit avoir un processus d’authentification.

Procédure

Section titled “Procédure”

Ce processus démarre lorsqu’un de vos utilisateurs clique sur le bouton « Choisir » de l’offre de son choix.

1/ Authentification de l’utilisateur

Section titled “1/ Authentification de l’utilisateur”

Si l’utilisateur est déjà authentifié au moment du clic, passez directement à l’étape 3.

Sinon, rediriger votre utilisateur vers votre formulaire d’inscription ou de connexion afin de récupérer les informations de votre utilisateur.

2/ Créer un client dans ProAbono.

Section titled “2/ Créer un client dans ProAbono.”

Appel n°1 - Créer un client

Requête :

POST https://api-{IdBusiness}.proabono.com/v1/customer
{
  "ReferenceCustomer": "123456",
  "Name": "John Doe",
  "Email": "[john@doe.com](mailto:john@doe.com)",
  "ReferenceSegment": "{ReferenceSegment}",
}

Voir la documentation complète

Si aucun code erreur ne vous a été retourné, alors un client a bien été créé dans votre environnement ProAbono.

3/ (facultatif)  Mettre à jour son adresse de facturation

Si vous connaissez l’adresse de facturation de votre client, vous pouvez nous la transmettre au travers de l’appel suivant :

Exemple requête

POST https://api-{IdBusiness}proabono.com/v1/CustomerBillingAddress?ReferenceCustomer=123456
{
  "Company": "John DOE SARL",
  "FirstName": "John",
  "LastName": "Doe",
  "AddressLine1": "123 avenue des Champs Elysées",
  "ZipCode": "75008",
  "City": "Paris","Country": "FR",
  "TaxInformation": "FR12345678"
}

Voir la documentation complète

Si aucun code erreur ne vous a été retourné, alors la mise à jour de l’adresse de facturation a bien été faite.

Appel n°3 - Créer un abonnement

Exemple requête

POST https://api-{IdBusinessProd}.proabono.com/v1/Subscription
{
  "ReferenceCustomer": "123456",
  "ReferenceOffer": "pro"
}

Remplacer la référence « pro » par la référence d’une des offres payantes précédemment créées depuis le backoffice ProAbono.
Dans la réponse, récupérer le lien “hosted-subscribe” et rediriger le client sur cette URL.
Voir la documentation complète

À noter, vous pouvez personnaliser l’abonnement lors de la création comme :

Pour aller plus loin

Une fois que votre client a cliqué sur le bouton qui permet de déclencher l’ensemble du workflow présenté ci-dessus, il doit être redirigé vers une page.

Vous pouvez depuis les paramètres du backoffice de ProAbono choisir l’URL de redirection de votre « thanks you page ». Cliquer ici pour découvrir ou faire cette configuration.