⚠️ Deprecated!!! This integration is no longer compatible with the changed Total Energies Club Card site since end 2025. This integration will no longer be supported.

TotalEnergies Club card Home Assistant integration

TotalEnergies Club card Home Assistant custom component integration for Belgium. This custom component has been built from the ground up to bring TotalEnergies Club card site data into Home Assistant sensors in order to follow up on club card points and free road assist coverage period. This integration is built against the public website provided by TotalEnergies for Belgium and has not been tested for any other countries.

This integration is in no way affiliated with TotalEnergies.

⚠️ Please don't report issues with this integration to TotalEnergies, they will not be able to support you.

Installation

• HACS: add url https://github.com/myTselection/TotalEnergiesClubCard as custom repository (HACS > Integration > option: Custom Repositories)
• Restart Home Assistant
• Add 'TotalEnergies Club Card' integration via HA Settings > 'Devices and Services' > 'Integrations'

Integration

Device TotalEnergies Club Card [cardnumber] should become available with the following sensors:

• TotalEnergies Club Card Assistance [cardnr] with indication of number of days the TotalEnergies Assistance is still available

  Attribute	Description
  State	Number of days the assistance coverage is valid
  Assistance coverage	Date till when the assistance coverage will remain available
  remaining days	Same as state
  Card nr	Card number

• TotalEnergies Club Card Points [cardnr] with number of points available on the TotalEnergies Club Card

  Attribute	Description
  State	Nr of points on TotalEngergies Club Card
  Happy fuel card	Indication of number of cards of 25€ and 15€ can be ordered with number of available points
  Card nr	Card number

• TotalEnergies Club Card Transactions [cardnr] with details on the last 10 transactions

  Attribute	Description
  State	Date of last transaction executed with the Club card
  Assistance coverage	Date till when the assistance coverage will remain available
  Last transaction date	Same a state
  Transactions	JSON with details of last transactions: date, location, number of points credited or debited
  Card nr	Card number

Status

Still some optimisations are planned, see Issues section in GitHub.

Technical pointers

The main logic and API connection related code can be found within source code Carbu.com/custom_components/Carbu.com:

• sensor.py
• utils.py -> mainly ComponentSession class

All other files just contain boilerplat code for the integration to work wtihin HA or to have some constants/strings/translations.

If you would encounter some issues with this custom component, you can enable extra debug logging by adding below into your configuration.yaml:

logger:
  default: info
  logs:
     custom_components.totalenergiesclubcard: debug

Example usage

Click to show the Mardown example

type: markdown
  content: >-
    {{states('sensor.totalenergies_club_card_assistance_[cardnr]')}} days
    Total Assistance coverage, till
    {{state_attr('sensor.totalenergies_club_card_assistance_[cardnr]','assistance_coverage')
    | as_timestamp| timestamp_custom("%a %d-%m-%Y")}}

    Points {{states('sensor.totalenergies_club_card_points_[cardnr]')}},
    {{state_attr('sensor.totalenergies_club_card_points_[cardnr]','happy_fuel_card')}}