• Assistance
  • Doc Produit
  • Zone Développeur
  • Référence API
  • Se connecter
  • FrançaisFrançais
    • EnglishEnglish
    • FrançaisFrançais
  • Assistance
  • Doc Produit
  • Zone Développeur
  • Référence API
  • Se connecter
  • FrançaisFrançais
    • EnglishEnglish
    • FrançaisFrançais
accueil/Assistance/Intégration/Procédure avancée : Achat intégré (2/2)

Procédure avancée : Achat intégré (2/2)

8 vues 0

< Article précédent : Achat intégré (1/2)

À l’instar des application 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.

Implémentation

Étape 1 : Récupérer le coût de la modification

L’appel permettant de faire toutes ces vérifications et de calculer le tarif d’un éventuel surcoût est Compute pricing usage.
 

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). Dans la plupart des cas, utiliser l’heure (UTC) actuelle.
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 :

 

Étape 2 : Confirmation de la modification

L’appel permettant de confirmer une modification est Update usage. Le contenu (body) de l’appel est strictement identique à l’appel précédent.
 
Exemple :

POST /v1/Usage?referenceCustomer=cust_1&referenceFeature=team-members

 
En cas de succès, le résultat est l’usage après ajustement.
{
  "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"
}

Cas supplémentaires (à gérer)

L’appel /v1/Pricing/Usage permet également des détecter plusieurs 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.

 

Cela vous a-t-il été utile ?

Oui  Non
Articles liés
  • Comment connecter un compte Zapier à ProAbono ?
  • Facturer plusieurs abonnements à un client dont il n’est pas le bénéficaire
  • Structure des pages hébergées
  • Procédure d’intégration du Portail Client (1/2)
  • Procédure d’intégration de ProAbono dans votre process d’inscription
  • Intégration – Synchroniser votre service avec ProAbono (1/5)
Intégration
  • Procédure avancée : Achat intégré (2/2)
  • Envoyer un e-mail avec Mailjet, Mailchimp, Sendgrid quand un événement survient
  • Envoyer les nouvelles factures PDF de ProAbono à Google Drive en utilisant Zapier
  • Intégration du Portail Client (2/2)
  • Terminologie
  • Liens cryptés
  • Qu’est ce qu’un Webhook ?
  • Cas Client – Tilkee, un éditeur SaaS
  • Comprendre ProAbono
  • Lib client ProAbono
  • Intégration – Synchroniser votre service avec ProAbono (2/5)
Afficher tout 25  
Articles populaires
  • Comprendre ProAbono
  • Modèle de Facture
  • 5 différences entre prélèvement SEPA et Carte Bancaire
  • Présentation de Postman pour l’API ProAbono
  • Procédure d’intégration du Portail Client (1/2)
Catégories
  • Guide de démarrage rapide
  • Intégration
    • Webhooks
    • Cas clients
    • Zapier
  • Offres & Abonnements
  • Portail client
  • Facturation
  • Extranet
  • Clients
  • Paiement
  • Non classifié(e
  • Dossiers

Ready to go
to the next level ?

Product
  • Aperçu
  • Encaissement et facturation
  • Souscription en ligne
  • Facturation à l’usage
  • Passerelles de paiement
Documentation
  • Base de connaissance
  • Zone développeur
  • Référence API
Contact
  • Parler avec un expert
  • Support / Assistance
  • Nous contacter
  • Nous recrutons
  • Mentions légales
  • Conditions Générales
  • Confidentialité
  • ProAbono © 2015-2022 Subscription Tech SAS. Tous droits réservés.