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 tunnel 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 tunnel de souscription de ProAbono pour finaliser sa souscription.
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
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
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.
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",
"ReferenceSegment": "{ReferenceSegment}",
}
ReferenceSegment : Il convient de créer le client dans le bon segment en fonction de son profil.
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 :
- ajouter ou modifier la période d’essai
- ajouter ou modifier les frais de démarrage
- modifier le tarif et/ou la périodicité de l’abonnement
- ajouter ou modifier le paramétrage d’une caractéristique dans l’abonnement (tarif, quantité, propriété, …)
- définir une date de démarrage dans le passé ou le futur
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.