Skip to main content

Tariff switch

General Overview

These features allow users to view available tariffs for a supply point and switch to a selected one.

Currently, this is specific to the OEGB API.

Market Specifics

GB 🇬🇧

This is a two-page journey:

  • Products Page – where the customer can view a high-level overview of offered tariffs.
  • Review Page – which displays a detailed breakdown of the selected tariff, including T&Cs and a CTA to perform the tariff switch.

The Products Page uses the supply point information to generate a quote. It does this via two sequential API operations:

  1. availableProductsForMeterPoint query:
    Fetches all available products for a given supply point. For OEGB, the input includes:

    • availableAt
    • mpxns
    • includeRestrictedProducts (optional, default is true)
  2. quoteAccountOnProducts mutation:
    Uses the product array from the previous query and returns tariff information. The input depends on the supply point fuel type (ElectricityMeterPointInput/ GasMeterPointInput).

Users can click on different available tariffs to view a more detailed breakdown in the QuoteBreakdown component:

  • <QuoteBreakdown />

The Review Page shows a detailed view of the selected tariff and allows the actual switch:

  1. quoteRequest:
    Fetches quote details using the quoteCode field (from the previous page).

  2. switchMeterPointProducts:
    Executes the switch using the MeterPointSwitchContext, which includes quotedProductId and mpxn.

This pages uses the following components:

  • <TariffInformation />:
    Displays an accordion with key-value pairs of tariff details.

  • <TermsAndConditions />:
    Displays a scrollable card with formatted terms and conditions.


Example

Products Page

Review Page