< Article précédent : Présentation du Portail Client

Pourquoi intégrer le Portail Client ?

  • Pour rendre vos clients autonomes et réduire les appels au support client
  • Pour disposer au plus vite des élément essentiels de la gestion d’abonnement
  • Pour ne pas avoir à coder et recoder cette partie si vous avez une langue, une devise ou ajustez vos offres
  • Pour éviter de coder les 60 pages (!) qui le compose

Comment intégrer le Portail Client

Avec un seul appel à l’API ProAbono : POST Customer

« Pourquoi POST ? J’ai déjà déclaré le Client au préalable ! »

  • Si l’utilisateur a changé son login ou son e-mail depuis, ça le met à jour dans ProAbono.
  • Si l’utilisateur a été supprimé ou n’a pas été déclaré dans ProAbono, ça l’ajoute à la volée.

ProAbono insére un nouveau Client ou met à jour un Client existant si la ReferenceCustomer existe déjà.

POST /v1/Customer
{
  "ReferenceCustomer": "123456",
  "Name": "John Doe",
  "Email": "john@doe.com",
  "Language": "en"
}
Des difficultés avec cette première requête ?
Utilisez POSTMAN afin de tester l’API et générer le code de cet appel dans votre langage favori.
Cliquez ici pour en savoir plus.

La réponse à cette requête contient des URL cryptées et sécurisées.

Response
{
    "Id": 64079,
    "ReferenceCustomer": "123456",
    "ReferenceSegment": "sandbox-eur",  
    "Name": "John Doe",
    "Email": "john@doe.com",
    "Language": "en",
    "Links": [
        {   "rel": "hosted-collection-offers",
            "href": "https://sandbox-eur.proabono.com/offers/{Unique-Encrypted-URL}"
        },
        {   "rel": "hosted-home",
            "href": "https://sandbox-eur.proabono.com/offers/{Another-Unique-Encrypted-URL}"
        }       
    ]
}

Le lien rel=hosted-collection-offers affiche la grille des offres et permet à ce Client de souscrire. Pour en savoir plus, consultez l’article Intégration dans votre process d’inscription

Le lien rel=hosted-home affiche l’accueil du Portail Client. Il affichera le statut de l’abonnement courant, proposera les upgrades, le téléchargement des factures, etc. C’est le lien à utiliser pour la section ‘Abonnement’ de votre service.

Il ne vous reste plus qu’à placer ce lien dans l’attribut src de votre tag iframe :

<iframe src="{hosted-home}" style="width:100%; height:700px;" frameborder="0"></iframe>

(Pensez à remplacer {hosted-home} par l’url du lien hosted-home)

Important : les liens cryptés ne sont pas des permaliens, ils peuvent expirer. Ne les enregistrez pas, utilisez l’API pour récupérer une version récente chaque fois que vous avez besoin de ces liens.

Étapes suivantes :

Intégration du portail client 2/2 >
Intégrer ProAbono dans votre process d’inscription >
Synchroniser votre service avec ProAbono >