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:
-
availableProductsForMeterPoint
query:
Fetches all available products for a given supply point. For OEGB, the input includes:availableAt
mpxns
includeRestrictedProducts
(optional, default istrue
)
-
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:
-
quoteRequest
:
Fetches quote details using thequoteCode
field (from the previous page). -
switchMeterPointProducts
:
Executes the switch using theMeterPointSwitchContext
, which includesquotedProductId
andmpxn
.
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.