Mettre en place de l’achat intégré ? – Assistance & Documentation

Concept

À l’instar des applications mobiles, l’achat intégré dans un service par abonnement permet au client d’effectuer des ajustements sur son abonnement ou d’augmenter sa consommation en quelques clics. C’est un des meilleurs moyens d’accroître vos revenus en réduisant les interactions avec le client.

Exemple (à décliner selon ce que vous facturez dans votre service) :

Un de vos utilisateurs souhaite effectuer une action qui peut déclencher un coût supplémentaire.

ajout d’un collaborateur
signature électronique d’un document
activation du support 24/24

En un seul appel à l’API ProAbono, vous récupérez le coût de la modification ainsi que le nouveau tarif de l’abonnement, en fonction de l’abonnement de cet utilisateur. Ces données vous permettent de construire une notification pour l’utilisateur afin que ce dernier confirme sa décision. Cette notification est obligatoire et évite que le client ne puisse contester sa facture à venir.

Si l’utilisateur appuie sur le bouton « confirmer », vous confirmez cette modification par API à ProAbono, qui se charge d’automatiser la partie facturation.

Le principal bénéfice, c’est que l’utilisateur n’a pas besoin de se rendre dans la section ‘Mon abonnement’ de votre application pour effectuer cette modification, ce qui fluidifie l’expérience utilisateur.

Autres avantages

Si l’utilisateur a un accès illimité ou si la modification n’entraîne pas de surcoût, l’appel API retourne un tarif à 0. Il est sans doute inutile de lui demander confirmation.

Si la modification est payante, l’appel permettra d’identifier les cas suivants :

l’utilisateur n’a pas de moyen de paiement enregistré
l’utilisateur a trop d’impayé et doit régulariser ses anciennes factures avant de continuer
l’utilisateur n’a pas accès à cette fonctionnalité

Selon le cas, il est recommandé de lui afficher un message avec un lien lui permettant d’enregistrer son moyen de paiement ou de changer d’offre.

Procédure

1/ Récupérez le coût de la modification

Le 1èr appel Compute pricing usage. permet de vérifier et de calculer le tarif d’un éventuel surcoût.

Exemple :

POST /v1/Pricing/Usage?referenceCustomer=cust_1&referenceFeature=team-members
{
  "Increment": 2,
  "DateStamp": "2018-12-31T15:31:00.00Z",
  "NextTerm": true,
}

DateStamp est la date de la modification en temps universel (UTC).

Résultat :

{
  "IdSegment": 7,
  "IdCustomer": 406146,
  "IdSubscription": 286407,
  "IdFeature": 6915,
  "ReferenceSegment": "dev",
  "ReferenceCustomer": "cust_1",
  "ReferenceFeature": "team-members",
  "LabelLocalized": "Net à payer",
  "PricingLocalized": "8.97 €",
  "Currency": "EUR",
  "AmountSubtotal": 748,
  "AmountTotal": 897,
  "DatePeriodStart": "2019-01-02T15:33:00.00Z",
  "DatePeriodTerm": "2019-01-31T15:29:27.00Z",
  "Details": [...],
  "NextTerm": {
    "IdSegment": 7,
    "IdCustomer": 406146,
    "IdSubscription": 286407,
    "ReferenceSegment": "dev",
    "ReferenceCustomer": "cust_1",
    "LabelLocalized": "Coût de l'abonnement après modification",
    "PricingLocalized": "220.78 €",
    "Currency": "EUR",
    "AmountSubtotal": 18399,
    "AmountTotal": 22078,
    "DatePeriodStart": "2019-01-31T15:29:27.00Z",
    "DatePeriodTerm": "2019-02-28T15:29:27.00Z",
    "Details": [...]
  }
}

ProAbono fourni automatiquement le libellé et le montant localisés dans la langue du client, pour le coût net à payer et le coût de l’abonnement après modification (dans le sous-object ‘NextTerm’).

Exemple d’affichage des données ci-dessus

2/ Confirmez les modifications

Le 2ème appel Update usage permet de confirmer les modifications.

Exemple :

POST /v1/Usage?referenceCustomer=cust_1&referenceFeature=team-members
{
  "IdSegment": 7,
  "IdFeature": 6915,
  "IdCustomer": 406146,
  "IdSubscription": 286407,
  "ReferenceSegment": "dev",
  "ReferenceFeature": "team-members",
  "ReferenceCustomer": "cust_1",
  "TypeFeature": "Limitation",
  "QuantityIncluded": 3,
  "QuantityCurrent": 9,
  "DatePeriodStart": "2018-12-31T15:29:27.00Z",
  "DatePeriodEnd": "2019-01-31T15:29:27.00Z"
}

En cas de succès, le résultat est l’usage après ajustement.

3/ Gérez les cas limites

L’appel /v1/Pricing/Usage permettant de détecter les cas où la modification n’est pas autorisée, il est souhaitable de gérer ces cas afin de permettre au client de faire le nécessaire en autonomie.

Lorsque ces cas se produisent, la réponse HTTP contient systématiquement :

Status HTTP : un statut HTTP 403 ou 404
Code : un code d’erreur unique

Voici les différents cas à gérer :

Caractéristique inacessible: HTTP 404 – Error.Api.Usage.NoneMatching Le client n’a aucun abonnement contenant cette caractéristique. Il doit changer d’offre. Solution : lui suggérer de changer d’offre.

Pas de moyen de paiement: Http 403 – Error.Customer.PaymentSettings.Missing La modification est payante, mais le client n’a pas de moyen de paiement d’enregistré. Solution : lui afficher le lien pour saisir ses moyens de paiement.

Trop d’impayés: Http 403 – Error.Customer.Billing.CappingReached La modification est payante, mais le client a trop d’impayés (selon les seuils définis dans vos paramètres). Solution : le client doit payer ses anciennes factures.

Zone Développeur