Contexte
Vous voulez maitriser le changement d’offre et souhaitez que vos clients upgradent uniquement vers des abonnements spécifiques et sur mesure déjà existants.
Ici, le client ne choisit pas d’offre vers laquelle le changement s’opère. Il est directement redirigé vers la souscription du nouvel abonnement que vous aurez spécifié.
Il n’est donc pas nécessaire de présenter une grille de changement d’offre.
Procédure
Étape 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}"
}
]
}
Étape 2a : Réaliser le changement d’offre vers l’abonnement cible.
Une fois l’Id récupéré. Vous pourrez réaliser le changement d’offre vers l’abonnement ciblé.
Pour ce faire, il vous suffit de réaliser un appel API en précisant l’Id de l’abonnement choisi, afin de déclencher le changement d’offre vers cet abonnement.
Cela réalise le changement d’offre instantanément.
Exemple : Upgrade a Subscription
POST https://api-2.proabono.com/v1/Subscription/{FromIdSubscription}/Upgrade?IdSubscription={ToIdSubscription}
Étape 2b : Rediriger le client dans le tunnel de changement d’offre l’abonnement cible.
Une fois l’Id récupéré. Vous pourrez récupérer un lien unique à transmettre à votre client pour réaliser le changement d’offre vers l’abonnement ciblé.
Pour ce faire, il vous suffit de réaliser un appel API de type GET en précisant l’Id de l’abonnement choisi. Cela permet de récupérer le lien appelé Hosted-Upgrade afin de rediriger le client dans le processus de changement d’offre vers celui-ci.
Exemple : Upgrade a Subscription to an other Subscription
GET https://api-2.proabono.com/v1/Subscription/{IdTargetedSubscription}/?IdSubscriptionToUpgrade={IdCurrentSubscription}
Réponse :
{
"Id": 812478,
"IdSegment": 1441,
"IdOffer": 9273,
"IdCustomer": 947094,
"IdCustomerBuyer": 947094,
"ReferenceSegment": "EUR",
"ReferenceOffer": "1000000000000000",
"ReferenceCustomer": "9fb7ca7d-c3dd-464a-ae17-e4a48a3f89dc",
"ReferenceCustomerBuyer": "9fb7ca7d-c3dd-464a-ae17-e4a48a3f89dc",
"StateSubscription": "InitiatedAgent",
"StateSubscriptionAfterTerm": "InitiatedAgent",
"IsEngaged": false,
"IsCustomerBillable": true,
"IsPaymentCappingReached": false,
"TitleLocalized": "Starter",
"AmountRecurrence": 35000,
"DurationRecurrence": 1,
"UnitRecurrence": "Month",
"Features": [
{
"Id": 8993,
"ReferenceFeature": "support-24",
"IsVisible": true,
"Properties": "None",
"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": false
},
{
"Id": 10503,
"ReferenceFeature": "bc23e4e1-bb3c-4f50-a992-b64a30689955",
"IsVisible": true,
"Properties": "None",
"TitleLocalized": "session",
"PricingLocalized": "10.00 €/unité",
"TypeFeature": "Limitation",
"QuantityIncluded": 0,
"QuantityCurrent": 0
}
],
"Discounts": [
{
"Id": 249,
"ReferenceDiscount": "3c07bec2-501b-4cbc-9ea0-b532993e66c9",
"TargetFee": "All",
"ValueOff": 1000,
"TypeOff": "PerTenThousand",
"Name": "Réduction 5 périodes - 10 %",
"TitleLocalized": "Réduction 5 périodes - 10 %"
}
],
"DateUpdate": "2022-11-29T15:44:19.50Z",
"Links": [
{
"rel": "self",
"href": "/v1/Subscription/812478"
},
{
"rel": "hosted-related-subscription",
"href": "https://Gestion-Relance-Commerciale-EUR.proabono.com/portal-sub/8Wc7fbwMVnRzObGlIyd8WmWbnPEmuUPPG61p0i8DtyncuV31V0nzb8rbjcDBN4rreaO-oOH5AVLj6HYT5XlL3PskNV_SjSG5P5bBnt4RTIc"
},
{
"rel": "hosted-subscribe",
"href": "https://Gestion-Relance-Commerciale-EUR.proabono.com/conclude/8Wc7fbwMVnRzObGlIyd8WmWbnPEmuUPPG61p0i8DtyncuV31V0nzb8rbjcDBN4rreaO-oOH5AVLj6HYT5XlL3PskNV_SjSG5P5bBnt4RTIc"
},
{
"rel": "hosted-register",
"href": "https://Gestion-Relance-Commerciale-EUR.proabono.com/register/8Wc7fbwMVnRzObGlIyd8WmWbnPEmuUPPG61p0i8DtyncuV31V0nzb8rbjcDBN4rreaO-oOH5AVLj6HYT5XlL3HMaCI7fV5S9boJBLrLGRKs"
},
{
"rel": "hosted-upgrade",
"href": "https://Gestion-Relance-Commerciale-EUR.proabono.com/upgrade-to-subscription/8Wc7fbwMVnRzObGlIyd8WmWbnPEmuUPPG61p0i8DtyncuV31V0nzb8rbjcDBN4rreaO-oOH5AVLj6HYT5XlL3G-M2wzB1UGxLaVf9XxNgOrL3P7Q7ZLQq3Eo5QfI7bQe"
}
]
}