Open APIs

 View Only
Expand all | Collapse all

Prepaid vs. Postpaid Product offerings in TMF Open API

  • 1.  Prepaid vs. Postpaid Product offerings in TMF Open API

    TM Forum Member
    Posted Jan 15, 2024 16:38

    Hi all,

    Is there a way to distinguish between Prepaid vs. Postpaid product offerings in TMF APIs? If yes, how can this be achieved? Or does TMF provide distinction of Postpaid vs. Prepaid at a different resource than Product Offerings?

    Varun Pandhi

  • 2.  RE: Prepaid vs. Postpaid Product offerings in TMF Open API

    TM Forum Member
    Posted Jan 16, 2024 02:51

    Hi Varun,

    To my knowledge, there is no such specific way to say that a product offering is prepaid or postpaid, but you have several alternatives to model that. Right now, the following come to mind:

    • You may extend the Product Offering class with Prepaid and Postpaid Product Offering specific classes. Regarding the API, this will be reflected in the field @type of the Product Offering resource.
    • You may use a characteristic associated with the product offering. For example, one named 'contract_type' that could take the value 'prepaid' or 'postpaid'.
    • You may just classify prepaid and postpaid offerings into different categories.

    Hope it helps.

    Best regards,

    Abel Ruiz Huerta

  • 3.  RE: Prepaid vs. Postpaid Product offerings in TMF Open API

    TM Forum Member
    Posted Jan 16, 2024 11:54

    Hi Varun, Abel,

    A productOffering doesn't have to be specific for Prepaid or Postpaid. If needed to restrict the use of productOfferings this is usually done through MarketSegment by having separate Prepaid and Postpaid. A ProductOffering then targets a marketsegment.

    The SID model provides a converged billing model that allows a customer to be set up with CustomerBillingAccounts that have a creditlimit and a set of balances. 

    A customer with a credit limit of 0 can basically only consume services via its prepaid balances.

    In that sense prepaid or postpaid is a marketsegment and customers in that marketsegment get their CustomerBillingAccount set up in a particular way.


    Koen Peeters
    OryxGateway FZ LLC

  • 4.  RE: Prepaid vs. Postpaid Product offerings in TMF Open API

    TM Forum Member
    Posted Jan 16, 2024 15:49

    An interesting discussion.

    In Amdocs best practice we distinguish directly between prepaid and postpaid offerings, by extending the vanilla TMF model. We then use this to qualify for specific customer types and other factors, for example to offer only prepaid offerings to customers with high credit risk.

    But there are many ways to skin a cat, as they say, and other suggestions made on this thread could be equally valid. I would not recommend, however, using characteristics for this purpose - for taking decisions in software it's more robust to have strongly-typed properties.

    Jonathan Goldberg
    Amdocs Management Limited
    Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.

  • 5.  RE: Prepaid vs. Postpaid Product offerings in TMF Open API

    TM Forum Member
    Posted Jan 17, 2024 08:36


    It really depends what you need to achieve. some examples we implemented

    • organise the customer front-end so they see prepaid and postpaid offers are displayed differently (different web pages etc)
      • a good solution is to use Product Catalogue and Catalogue categories
    • Manage a product porftfolio or group product with common characteristics
      • a good solution is to use Product Line or Product Category (which can be nested, linked etc). see GB922 Product for details, It's not supported by the 620 API, though.
      • I would love TMF to introduce product line and category at product offering level, (not just prodspec) so marketeers have more flexibility to organise or tag product offers from a marketing and sales perspective. You can use a PIM (product information management) for that purpose or even a CMS.

    there could be more use cases, for billing, pricing, common qualification rules... with different solutions.

    On a old project, we had to use the Product offering related pricetype (recurring vs one-time) to distinguish prepaid from postpaid because this distinction was used to trigger a credit check (if the product has a recurring charge).

    PS: I would avoid Market Segment. It's not meant to group product offering. to group the target audience of a product offering. you use market Segment to group Parties (customers, GeographicAreas, SalesChannels). As the information model writes, "MarketSegments are the target of MarketingCampaigns, ProductOfferings, ProductPromotions...)

    PS: I also see that prepaid and postpaid no longer mean what they used to mean 10 years. My ISP use the term "prepaid" for my internet subscription because the invoice is sent and must be paid a  month before the service is delivered!

    Kind regards,

    Matthieu Hattab
    Lyse Platform