• Assistance
  • API Reference
  • Sign in
  • EnglishEnglish
    • EnglishEnglish
    • FrançaisFrançais
  • Assistance
  • API Reference
  • Sign in
  • EnglishEnglish
    • EnglishEnglish
    • FrançaisFrançais
accueil/Assistance/Integration/Integration – Synchronize your service with ProAbono (3/5)

Integration – Synchronize your service with ProAbono (3/5)

17 vues 0

This series of articles gives the best practices to integrate ProAbono. Pass it on to your technical team if you want a perennial integration that allows you to create offers and subscriptions on the fly without technical assistance.
<< Chapter 1
< Previous chapter: Implementing rights synchronization with ProAbono

Chap 3. Mapping your rights management with your subscriptions

The Characteristics

The Feature is the only resource you need to know to manage rights.

A Feature allows you to define a variable that is used both to influence the price of a subscription, but also to determine rights in your service.

A Feature can be hidden if it is useful for releasing rights but you do not want to show it to the customer.

Each feature is associated with a unique reference (ReferenceFeature) of your choice.

See the API documentation

GET /v1/Usages?ReferenceCustomer=123456
{
  "Page": 1,
  "SizePage": 10,
  "Count": 3,
  "TotalItems": 3,
  "DateGenerated": "2018-02-08T17:00:29.28Z",
  "Items": [
    {
      "Id": 1797,
      "IsVisible": true,
      "ReferenceFeature": "Users",
      "TypeFeature": "Limitation",
      "ReferenceCustomer": "123456",
      "QuantityIncluded": 3,
      "QuantityCurrent": 4
    },
    {
      "Id": 1785,
      "IsVisible": true,
      "ReferenceFeature": "Quota",
      "TypeFeature": "Consumption"
      "ReferenceCustomer": "123456",
      "QuantityIncluded": 100,
      "QuantityCurrent": 357
    },
    {
      "Id": 5478,
      "IsVisible": true,
      "ReferenceFeature": "Premium-Access",
      "TypeFeature": "OnOff",
      "ReferenceCustomer": "123456",
      "IsIncluded": true,
      "IsEnabled": true
    }
  ]
}

Types of characteristics

OnOff

  • Binary value
  • example: access to the Premium section

Consumption

  • Positive integer value
  • Represents a consumption: a volume that is periodically reset to zero.
  • example: a quota, a number of SMS sent monthly

Limitation

  • Positive integer value
  • Represents a persistent volume over time
  • example: the number of users

These specifications are sufficient to manage rights in any service. Can’t see how to cover your needs? Want more information? Contact us

Use

For OnOff features, the API will tell you whether or not it is enabled.

If several subscriptions coexist and you have asked for a combined value, then the answer will be ‘enabled’, if at least one subscription has this feature enabled.

For the Limit and Consumption features, the API will tell you the known value.

If the field “QuantityCurrent” is not indicated, it means that the quantity is unlimited, enjoy!

If several subscriptions coexist and you have asked for a combined value, then the answer will be the sum of the values for each subscription. If a subscription is unlimited, the answer will be ‘unlimited’.

In the next chapter we will see how to request rights by Client and by Feature >.

Was this helpful?

Yes  No
Related posts
  • Integration – Synchronize your service with ProAbono (4/5)
  • Integration – Synchronize your service with ProAbono (5/5)
  • Integration – Sync your online service with ProAbono (2/5)
  • WP Tuto #Advanced – User Data Synchronization with ProAbono
  • WP Tuto #Advanced – Set up Content Access Restrictions
  • WP Tuto #6 – Set up Payment Success Redirections
Integration
  • Integration – Synchronize your service with ProAbono (3/5)
  • What is a Segment
  • Terminology
  • Need a Sandbox
  • When should I create a Segment ?
  • Is there a plugin for Spip, Joomla, Magento, PrestaShop?
  • Do you have an API ?
  • iFrame integration
  • ProAbono available on Zapier
  • Understanding ProAbono
  • Encrypted links
Afficher tout 47  
Popular Articles
  • Customer Portal Integration (1/2)
  • Invoice Model
  • Understanding ProAbono
  • Update the billing information of a customer
  • WP Tuto #3 – Display your Offers on your Homepage
Categories
  • Quick Start Guide
  • Integration
    • Zapier
    • Plugin CMS
      • WordPress
    • Events / Webhooks
    • Customer Case Study
  • Offers & Subscriptions
    • Pricing Tables
  • Hosted Pages (Customer Portal
  • Invoicing / Billing
  • Backoffice
  • Customers
  • Payment
  • Doing Business Worldwide
  • Troubleshooting
  • Email Notifications
  • Uncategorized

Ready to go
to the next level ?

Product
  • Overview
  • Charging & Invoicing
  • Online Subscription
  • Usage-based Billing
  • Payment Gateways
Documentation
  • Knowledge Base
  • Developer Zone
  • API Reference
Contact
  • Talk with an expert
  • Customer Support
  • Contact us
  • Terms of Use
  • Privacy Policy
  • ProAbono © 2015-2022 Subscription Tech SAS. Tous droits réservés.