Contexte
Vous voulez maitriser le changement d’offre et souhaitez que vos clients upgradent uniquement vers une offre spécifique de votre catalogue d’offres.
Ici, le client ne choisit pas d’offre vers laquelle le changement s’opère. Il est directement redirigé vers la souscription de la nouvelle offre que vous aurez spécifié.
Il n’est donc pas nécessaire de présenter une grille de changement d’offre.
Procédure
Etape 1 : Récupérer l’Id de l’abonnement courant.
Dans ce cas de figure, vous devez dans un premier temps récupérer l’Id de l’abonnement actuel du client au travers d’un appel API.
Il vous faudra simplement connaitre la référence du client concerné.
Exemple : Retrieve a Subsciption
GET https://api-2.proabono.com/v1/Subscription?ReferenceCustomer={ReferenceCustomer}
Réponse :
{
"Id": 594627,
"IdSegment": 1441,
"IdOffer": 9282,
"IdCustomer": 786678,
"IdCustomerBuyer": 786678,
"ReferenceSegment": "1bis",
"ReferenceOffer": "2",
"ReferenceCustomer": "10381d0a-d1d1-4f6f-a67e-f9d0f0fb5cc9",
"ReferenceCustomerBuyer": "10381d0a-d1d1-4f6f-a67e-f9d0f0fb5cc9",
"StateSubscription": "Running",
"DateStart": "2021-04-23T13:13:14.00Z",
"DatePeriodStart": "2022-02-23T13:13:14.00Z",
"DatePeriodEnd": "2022-03-23T13:13:14.00Z",
"DateTerm": "2022-03-23T13:13:14.00Z",
"DateResetConsumption": "2022-03-23T13:13:14.00Z",
"StateSubscriptionAfterTerm": "Running",
"IsEngaged": false,
"IsCustomerBillable": true,
"IsPaymentCappingReached": false,
"DateNextBilling": "2022-03-23T19:13:14.00Z",
"TitleLocalized": "Test 2",
"AmountUpFront": 0,
"AmountRecurrence": 6000,
"DurationRecurrence": 1,
"UnitRecurrence": "Month",
"DateUpdate": "2022-02-24T11:14:19.91Z",
"Links": [
{
"rel": "self",
"href": "/v1/Subscription/594627"
},
{
"rel": "hosted-related-subscription",
"href": "https://https://sandbox-eur.proabono.com/portal-sub/{Unique-Encrypted-URL1}"
},
{
"rel": "hosted-upgrade",
"href": "https://https://sandbox-eur.proabono.com/upgrades/{Unique-Encrypted-URL2}"
}
]
}
Etape 2a : Réaliser le changement d’offre vers l’offre cible.
Une fois l’Id récupéré. Vous pourrez réaliser le changement d’offre vers l’offre ciblée.
Pour ce faire, il vous suffit de réaliser un appel API de type POST en précisant la référence de l’offre choisie, afin de déclencher le changement d’offre vers celle-ci.
Cela réalise le changement d’offre instantanément.
Exemple : Upgrade a Subscription
POST https://api-2.proabono.com/v1/Subscription/{IdSubscription}/Upgrade?ReferenceOffer={ReferenceOffer}
Etape 2b : Rediriger le client dans le tunnel de changement d’offre vers l’offre cible.
Une fois l’Id récupéré. Vous pourrez récupérer un lien unique a transmettre à votre client pour réaliser le changement d’offre vers l’offre ciblée.
Pour ce faire, il vous suffit de réaliser un appel API de type GET en précisant la référence de l’offre choisie. Cela permet de récupérer le lien appelé Hosted-Upgrade afin de rediriger le client dans le processus de changement d’offre vers celle-ci.
Exemple : Upgrade a Subscription to an offer
GET https://api-2.proabono.com/v1/Subscription/{IdSubscription}/Upgrade?ReferenceOffer={ReferenceOffer}
Réponse :
{
"Id": 778811,
"IdSegment": 1441,
"IdOffer": 10539,
"IdCustomer": 945238,
"IdCustomerBuyer": 945238,
"ReferenceSegment": "EUR",
"ReferenceOffer": "offretest",
"ReferenceCustomer": "9164b20e-fbb3-4fd7-a479-bf785176ee43",
"ReferenceCustomerBuyer": "9164b20e-fbb3-4fd7-a479-bf785176ee43",
"StateSubscription": "Running",
"DateStart": "2022-09-22T07:38:12.00Z",
"DatePeriodStart": "2022-11-22T07:38:12.00Z",
"DatePeriodEnd": "2022-12-22T07:38:12.00Z",
"DateTerm": "2022-12-22T07:38:12.00Z",
"DateResetConsumption": "2022-12-22T07:38:12.00Z",
"StateSubscriptionAfterTerm": "Running",
"IsEngaged": false,
"IsCustomerBillable": true,
"IsPaymentCappingReached": false,
"DateNextBilling": "2022-11-22T13:38:12.00Z",
"TitleLocalized": "Offer Premium ",
"AmountUpFront": 1000,
"AmountRecurrence": 15000,
"DurationRecurrence": 1,
"UnitRecurrence": "Month",
"Features": [
{
"Id": 8993,
"ReferenceFeature": "support-24",
"IsVisible": true,
"Properties": "UpdatableBeforeSubscription, UpdatableAfterSubscription",
"TitleLocalized": "24/7 Support",
"DescriptionLocalized": "Le support est essentiellement joignable depuis la bulle en bas de page. Vous pouvez néanmoins accéder au support depuis votre boite mail lorsque vous quitter l'application Web.",
"PricingLocalized": "en option+10.00 €",
"TypeFeature": "OnOff",
"IsIncluded": false,
"IsEnabled": true
},
{
"Id": 8994,
"ReferenceFeature": "Nombre d'utilisateur",
"IsVisible": true,
"Properties": "None",
"TitleLocalized": "Nombre d'utilisateur",
"PricingLocalized": "1.00 €/unité",
"TypeFeature": "Limitation",
"QuantityIncluded": 0,
"QuantityCurrent": 0
},
{
"Id": 10661,
"ReferenceFeature": "5a667ce6-e173-485a-9a3f-48937632583e",
"IsVisible": true,
"Properties": "UpdatableBeforeSubscription, UpdatableAfterSubscription",
"TitleLocalized": "Caractéristique avec Tarif par défaut",
"PricingLocalized": "à partir de2.50 €/unité suppl.",
"TypeFeature": "Limitation",
"QuantityIncluded": 5,
"QuantityCurrent": 10
}
],
"DateUpdate": "2022-11-22T07:38:17.52Z",
"Links": [
{
"rel": "self",
"href": "/v1/Subscription/778811"
},
{
"rel": "hosted-related-subscription",
"href": "https://Gestion-Relance-Commerciale-EUR.proabono.com/portal-sub/Y-pkLkckwBhAuaA9Zv4WRe4iqzJod8eyn7shenAiSVWgohfzUtWTKqe3F6Hj6vWURtpTMdKxyyFghoOxm8PxFtbwdpP6wQOBMNbg3Qpzjh4"
},
{
"rel": "hosted-upgrade",
"href": "https://Gestion-Relance-Commerciale-EUR.proabono.com/upgrade-to-offer/Y-pkLkckwBhAuaA9Zv4WRe4iqzJod8eyn7shenAiSVWgohfzUtWTKqe3F6Hj6vWURtpTMdKxyyFghoOxm8PxFrY2LAJy8_NqOgvMcsJrs6V7yTDz7WV3fPC2dPndTyIH"
}
]
}