Contexte
La grille de présentation des Offres est une page hébergée vous permettant d’afficher au client la liste des offres disponibles à la souscription.
L’objectif est de lui permettre de comparer les différentes options liées à votre service qui s’offrent à lui et de choisir celle qui leur convient le mieux.
S’il clique sur un bouton « souscrire » alors, il sera redirigé directement vers le tunnel de souscription.
Procédure
Pour inclure cette page dans votre site, vous devez récupérer le lien associer à votre client.
La page est lié à un client, car la page et les processus qui en découle s’afficheront en fonction de son contexte.
1/ Récupérer le lien lors de la création d’un client
Requête :
POST https://api-2.proabono.com/v1/Customer
{
"ReferenceCustomer": "123456",
"Name": "John Doe",
"Email": "john@doe.com",
"Language": "en""
}
Réponse :
{
"Id": 72461,
"IdSegment": 3,
"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/pricing/{Unique-Encrypted-URL1}"
},
{
"rel": "hosted-home",
"href": "https://sandbox-eur.proabono.com/portal/{Unique-Encrypted-URL2}"
},
{
"rel": "hosted-register",
"href": "https://sandbox-eur.proabono.com/register/{Unique-Encrypted-URL3}"
}
]
}
Grâce à cet appel, vous allez créer ou mettre à jour le bon client et récupérer à la volée le lien vers la page de présentation des offres.
Copier le lien href correspondant à la clé “hosted-collection-offers” (https://sandbox-eur.proabono.com/pricing/xxxxx dans notre exemple).
À noter :
– Si le client n’existe pas encore dans ProAbono, il sera automatiquement créé.
– Si le client existe déjà, l’appel aura pour effet de simplement mettre à jour les données du client (le POST sera alors interprété comme un PATCH).
– Si le client n’existe pas encore dans ProAbono, il sera automatiquement créé.
– Si le client existe déjà, l’appel aura pour effet de simplement mettre à jour les données du client (le POST sera alors interprété comme un PATCH).
2/ Rediriger le client sur la page de présentation des offres
Une fois le bon lien récupéré, vous devez l’utiliser comme source d’une Iframe.
À noter : le lien Hosted-Collection-Offers est présent dans la réponse d’un appel API sur la ressource Customer. Il est donc possible de le récupérer par le biais d’un GET Customer si celui-ci est déjà existant dans la base de données ProAbono.