Aller au contenu
ProAbonoProAbonoProAbono Docs

Changement d'offre vers une offre prédéfinie

Contexte

Section titled “Contexte”

Vous voulez maîtriser 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

Section titled “Procédure”

Étape 1 : Récupérer l’Id de l’abonnement courant.

Section titled “É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 connaître la référence du client concerné.

Exemple : récupérer un abonnement

GET https://api-42.proabono.com/v1/Subscription?ReferenceCustomer={ReferenceCustomer}

Réponse

{
  "Id": 44088,
  "IdSegment": 69,
  "IdOffer": 16666,
  "IdCustomer": 133700,
  "IdCustomerBuyer": 133700,
  "ReferenceSegment": "demo-eur",
  "ReferenceOffer": "offer-premium",
  "ReferenceCustomer": "cust-42",
  "ReferenceCustomerBuyer": "cust-42",
  "StateSubscription": "Running",
  "DateStart": "2026-01-15T09:12:00.00Z",
  "DatePeriodStart": "2026-07-15T09:12:00.00Z",
  "DatePeriodEnd": "2026-08-15T09:12:00.00Z",
  "DateTerm": "2026-08-15T09:12:00.00Z",
  "DateResetConsumption": "2026-08-15T09:12:00.00Z",
  "StateSubscriptionAfterTerm": "Running",
  "IsEngaged": false,
  "IsCustomerBillable": true,
  "IsPaymentCappingReached": false,
  "DateNextBilling": "2026-08-15T09:12:00.00Z",
  "TitleLocalized": "Premium",
  "AmountUpFront": 0,
  "AmountRecurrence": 37900,
  "DurationRecurrence": 1,
  "UnitRecurrence": "Month",
  "DateUpdate": "2026-07-15T09:12:00.00Z",
  "Links": [
    {
      "rel": "self",
      "href": "/v1/Subscription/44088"
    },
    {
      "rel": "hosted-related-subscription",
      "href": "https://demo-eur.proabono.com/portal-sub/{PortalSubToken}"
    },
    {
      "rel": "hosted-upgrade",
      "href": "https://demo-eur.proabono.com/upgrades/{UpgradeToken}"
    }
  ]
}

Étape 2a : Réaliser le changement d’offre vers l’offre cible.

Section titled “Étape 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 : changer l’offre d’un abonnement

POST https://api-42.proabono.com/v1/Subscription/{IdSubscription}/Upgrade?ReferenceOffer={ReferenceOffer}

Étape 2b : Rediriger le client dans le parcours de changement d’offre vers l’offre cible.

Section titled “Étape 2b : Rediriger le client dans le parcours 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 : changer un abonnement vers une offre

GET https://api-42.proabono.com/v1/Subscription/{IdSubscription}/Upgrade?ReferenceOffer={ReferenceOffer}

Réponse

{
  "Id": 44088,
  "IdSegment": 69,
  "IdOffer": 16667,
  "IdCustomer": 133700,
  "IdCustomerBuyer": 133700,
  "ReferenceSegment": "demo-eur",
  "ReferenceOffer": "offer-business",
  "ReferenceCustomer": "cust-42",
  "ReferenceCustomerBuyer": "cust-42",
  "StateSubscription": "Running",
  "DateStart": "2026-01-15T09:12:00.00Z",
  "DatePeriodStart": "2026-07-15T09:12:00.00Z",
  "DatePeriodEnd": "2026-08-15T09:12:00.00Z",
  "DateTerm": "2026-08-15T09:12:00.00Z",
  "DateResetConsumption": "2026-08-15T09:12:00.00Z",
  "StateSubscriptionAfterTerm": "Running",
  "IsEngaged": false,
  "IsCustomerBillable": true,
  "IsPaymentCappingReached": false,
  "DateNextBilling": "2026-08-15T09:12:00.00Z",
  "TitleLocalized": "Business",
  "AmountUpFront": 0,
  "AmountRecurrence": 54900,
  "DurationRecurrence": 1,
  "UnitRecurrence": "Month",
  "Features": [
    {
      "Id": 1003,
      "ReferenceFeature": "feat-support-24",
      "IsVisible": true,
      "Properties": "UpdatableBeforeSubscription, UpdatableAfterSubscription",
      "TitleLocalized": "Support 24/7",
      "DescriptionLocalized": "Assistance par téléphone et e-mail, à toute heure.",
      "PricingLocalized": "en option +10,00 €",
      "TypeFeature": "OnOff",
      "IsIncluded": false,
      "IsEnabled": true
    },
    {
      "Id": 1000,
      "ReferenceFeature": "feat-team-members",
      "IsVisible": true,
      "Properties": "None",
      "TitleLocalized": "Collaborateur(s)",
      "PricingLocalized": "1,00 €/unité",
      "TypeFeature": "Limitation",
      "QuantityIncluded": 0,
      "QuantityCurrent": 0
    },
    {
      "Id": 1004,
      "ReferenceFeature": "feat-projects",
      "IsVisible": true,
      "Properties": "UpdatableBeforeSubscription, UpdatableAfterSubscription",
      "TitleLocalized": "Projet(s)",
      "PricingLocalized": "à partir de 2,50 €/unité suppl.",
      "TypeFeature": "Limitation",
      "QuantityIncluded": 5,
      "QuantityCurrent": 10
    }
  ],
  "DateUpdate": "2026-07-15T09:12:00.00Z",
  "Links": [
    {
      "rel": "self",
      "href": "/v1/Subscription/44088"
    },
    {
      "rel": "hosted-related-subscription",
      "href": "https://demo-eur.proabono.com/portal-sub/{PortalSubToken}"
    },
    {
      "rel": "hosted-upgrade",
      "href": "https://demo-eur.proabono.com/upgrades/{UpgradeToken}"
    }
  ]
}