Skip to content
e-Gridium
Menu

Partners · For CPOs

For charge point operators

Publish your locations and tariffs once; decide per partner which eMSP sees which site; receive sessions, CDRs and settlement statements from one place.

You send
locations · tariffs · sessions · cdrs · tr-cdr-additionals · parking
You receive
tokens · commands · chargingprofiles
You decide
which eMSP sees which sharing set
Hub topology: several CPOs and eMSPs connect to the ChargeBridge hub once; accepted relationships decide which arrow is open.
You connect once; which eMSP sees which sharing set is decided per relationship.

For CPOs

Partners in this role ask for

Four requests, four answers. Each has its counterpart in the module table and the portal views below.

  1. 01

    Reach drivers of several eMSP apps without a separate integration for each

  2. 02

    Keep control of which sites and tariffs each partner can see

  3. 03

    Get a netting statement per period instead of reconciling partner by partner

  4. 04

    Carry the Türkiye-specific CDR fields without a custom integration

Module

Modules you use

Direction is the flow between you and the hub in this role. Status says what the service covers; the evidence level says what the claim rests on.

OCPI modules →
Module Version Direction Summary Status Evidence
credentials OCPI 2.2.1 Sender and receiver Registration handshake and token lifecycle between a partner and the hub. Offered
1/4 Present in source code
Inspect evidence

OCPI 2.2.1 route table· Source code review

The OCPI adapter mounts controllers for credentials, locations, sessions, cdrs, tariffs, tokens, commands, chargingprofiles and hubclientinfo under the 2.2.1 version endpoint, with auth, idempotency, rate-limit and audit middleware.

Supports:That the nine 2.2.1 modules are implemented and routed in the hub.

Does not show:Interoperability with a specific partner’s implementation; that is established per partner in the sandbox and the acceptance checklist.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

Fail-closed partner relationships· Source code review

No location, tariff, session, CDR or token flows unless an explicitly accepted, active partner relationship exists between the two parties; publish scope defaults to deny and changes are written to an audit ledger.

Supports:That a completed credentials handshake does not open data flow and that scope is an explicit, auditable decision.

Does not show:Contractual data-sharing permissions; those come from the signed agreement and DPA.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

Partner sandbox· Source code review

Sandbox routes in the OCPI adapter and a mock partner and charger simulator let a partner complete the handshake and exercise each module against test data before onboarding.

Supports:That a test environment is part of onboarding.

Does not show:Self-service sign-up; sandbox credentials are issued after the application is reviewed.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

All evidence records →
locations OCPI 2.2.1 Sender Locations, EVSEs and connectors with live status. Offered
1/4 Present in source code
Inspect evidence

OCPI 2.2.1 route table· Source code review

The OCPI adapter mounts controllers for credentials, locations, sessions, cdrs, tariffs, tokens, commands, chargingprofiles and hubclientinfo under the 2.2.1 version endpoint, with auth, idempotency, rate-limit and audit middleware.

Supports:That the nine 2.2.1 modules are implemented and routed in the hub.

Does not show:Interoperability with a specific partner’s implementation; that is established per partner in the sandbox and the acceptance checklist.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

Fail-closed partner relationships· Source code review

No location, tariff, session, CDR or token flows unless an explicitly accepted, active partner relationship exists between the two parties; publish scope defaults to deny and changes are written to an audit ledger.

Supports:That a completed credentials handshake does not open data flow and that scope is an explicit, auditable decision.

Does not show:Contractual data-sharing permissions; those come from the signed agreement and DPA.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

All evidence records →
tariffs OCPI 2.2.1 Sender Tariff definitions with price components and restrictions. Offered
1/4 Present in source code
Inspect evidence

OCPI 2.2.1 route table· Source code review

The OCPI adapter mounts controllers for credentials, locations, sessions, cdrs, tariffs, tokens, commands, chargingprofiles and hubclientinfo under the 2.2.1 version endpoint, with auth, idempotency, rate-limit and audit middleware.

Supports:That the nine 2.2.1 modules are implemented and routed in the hub.

Does not show:Interoperability with a specific partner’s implementation; that is established per partner in the sandbox and the acceptance checklist.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

Fail-closed partner relationships· Source code review

No location, tariff, session, CDR or token flows unless an explicitly accepted, active partner relationship exists between the two parties; publish scope defaults to deny and changes are written to an audit ledger.

Supports:That a completed credentials handshake does not open data flow and that scope is an explicit, auditable decision.

Does not show:Contractual data-sharing permissions; those come from the signed agreement and DPA.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

All evidence records →
sessions OCPI 2.2.1 Sender Charging sessions in progress, from start to end. Offered
1/4 Present in source code
Inspect evidence

OCPI 2.2.1 route table· Source code review

The OCPI adapter mounts controllers for credentials, locations, sessions, cdrs, tariffs, tokens, commands, chargingprofiles and hubclientinfo under the 2.2.1 version endpoint, with auth, idempotency, rate-limit and audit middleware.

Supports:That the nine 2.2.1 modules are implemented and routed in the hub.

Does not show:Interoperability with a specific partner’s implementation; that is established per partner in the sandbox and the acceptance checklist.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

Fail-closed partner relationships· Source code review

No location, tariff, session, CDR or token flows unless an explicitly accepted, active partner relationship exists between the two parties; publish scope defaults to deny and changes are written to an audit ledger.

Supports:That a completed credentials handshake does not open data flow and that scope is an explicit, auditable decision.

Does not show:Contractual data-sharing permissions; those come from the signed agreement and DPA.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

All evidence records →
cdrs OCPI 2.2.1 Sender Charge detail records: the billable record of a session. Offered
2/4 Real screen or document
Inspect evidence

OCPI 2.2.1 route table· Source code review

The OCPI adapter mounts controllers for credentials, locations, sessions, cdrs, tariffs, tokens, commands, chargingprofiles and hubclientinfo under the 2.2.1 version endpoint, with auth, idempotency, rate-limit and audit middleware.

Supports:That the nine 2.2.1 modules are implemented and routed in the hub.

Does not show:Interoperability with a specific partner’s implementation; that is established per partner in the sandbox and the acceptance checklist.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

Settlement window state machine· Source code review

The clearing platform moves each settlement window through OPEN, GRACE_PERIOD, RECONCILING and CLOSED; late CDRs enter during the grace period and disputes surface before close.

Supports:That settlement periods, netting statements and payment obligations are produced by the platform.

Does not show:That money has moved between partners through the hub: settlement runs in dry-run until the financial go-live gate closes, and invoicing is fenced until then.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

Hash-chained settlement ledger· Source code review

Ledger entries are chained by hash so a statement can be re-verified against its inputs; hub fees are booked as separate lines for each party and never netted against roaming amounts.

Supports:Tamper-evidence of the ledger and the “hub fee outside netting” rule.

Does not show:Fee rates or splits; those are in the participation agreement, not on this site.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

Fail-closed partner relationships· Source code review

No location, tariff, session, CDR or token flows unless an explicitly accepted, active partner relationship exists between the two parties; publish scope defaults to deny and changes are written to an audit ledger.

Supports:That a completed credentials handshake does not open data flow and that scope is an explicit, auditable decision.

Does not show:Contractual data-sharing permissions; those come from the signed agreement and DPA.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

Settlement architecture: agreements, windows, statements, obligations· Document

Bilateral, versioned agreements define cycle, grace period, dispute window, fee allocation, payment automation and FX policy; windows move OPEN → GRACE_PERIOD → RECONCILING → CLOSED; statements move GENERATED → PUBLISHED → ACKNOWLEDGED and are hub-signed; obligations carry debtor, creditor, amount and due date.

Supports:The structure described on the settlement page.

Does not show:Any rate, amount or that real money has moved; payment automation beyond manual mode is configured per partner after the financial go-live gate.

Source: Hub repository, docs/architecture/settlement (domain model, state machines, cycle computation) · Verified4 October 2026

All evidence records →
tokens OCPI 2.2.1 Receiver Driver tokens (RFID, app) and real-time authorization. Offered
1/4 Present in source code
Inspect evidence

OCPI 2.2.1 route table· Source code review

The OCPI adapter mounts controllers for credentials, locations, sessions, cdrs, tariffs, tokens, commands, chargingprofiles and hubclientinfo under the 2.2.1 version endpoint, with auth, idempotency, rate-limit and audit middleware.

Supports:That the nine 2.2.1 modules are implemented and routed in the hub.

Does not show:Interoperability with a specific partner’s implementation; that is established per partner in the sandbox and the acceptance checklist.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

Fail-closed partner relationships· Source code review

No location, tariff, session, CDR or token flows unless an explicitly accepted, active partner relationship exists between the two parties; publish scope defaults to deny and changes are written to an audit ledger.

Supports:That a completed credentials handshake does not open data flow and that scope is an explicit, auditable decision.

Does not show:Contractual data-sharing permissions; those come from the signed agreement and DPA.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

Retention sweep for token material· Source code review

Hashed token data and encrypted credentials are deleted as soon as their retention time expires; the sweep runs on a schedule and is the most conservative setting available.

Supports:The delete-on-expiry rule stated on the trust page.

Does not show:A data-controller’s own retention obligations; those are set in each DPA.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

All evidence records →
commands OCPI 2.2.1 Receiver Remote start, stop, reserve and unlock, relayed through the hub. Offered
1/4 Present in source code
Inspect evidence

OCPI 2.2.1 route table· Source code review

The OCPI adapter mounts controllers for credentials, locations, sessions, cdrs, tariffs, tokens, commands, chargingprofiles and hubclientinfo under the 2.2.1 version endpoint, with auth, idempotency, rate-limit and audit middleware.

Supports:That the nine 2.2.1 modules are implemented and routed in the hub.

Does not show:Interoperability with a specific partner’s implementation; that is established per partner in the sandbox and the acceptance checklist.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

All evidence records →
chargingprofiles OCPI 2.2.1 Receiver Smart-charging profiles set and read through the hub. Offered
1/4 Present in source code
Inspect evidence

OCPI 2.2.1 route table· Source code review

The OCPI adapter mounts controllers for credentials, locations, sessions, cdrs, tariffs, tokens, commands, chargingprofiles and hubclientinfo under the 2.2.1 version endpoint, with auth, idempotency, rate-limit and audit middleware.

Supports:That the nine 2.2.1 modules are implemented and routed in the hub.

Does not show:Interoperability with a specific partner’s implementation; that is established per partner in the sandbox and the acceptance checklist.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

All evidence records →
tr-cdr-additionals TR extension Sender Türkiye profile: the CDR fields local regulation and tax rules need, carried as an OCPI extension. Offered
2/4 Real screen or document
Inspect evidence

Türkiye CDR extension (tr-cdr-additionals)· Source code review

A dedicated controller and integration profile carry the utility rate in TRY/kWh, VAT breakdown and reporting identifiers next to each CDR. The underlying OCPI-TR custom module specification (v1.0.0, January 2026) was authored by ZES; E-Gridium implements it as published and credits ZES for the work.

Supports:That the Türkiye profile exists as an OCPI extension on both sender and receiver side.

Does not show:Regulatory acceptance by any authority; the fields are what the parties need for their own reporting.

Source: OCPI-TR Custom Modules specification v1.0.0 (ZES, 19 January 2026) and the hub source repository (private) · Verified4 October 2026

Türkiye profile: binding interpretation of tr-cdradditionals· Document

Eight rules the hub applies where the specification leaves room: unit price semantics and precision, VAT handling, versioned corrections, idempotency responses, discovery via version details, eventual matching with a 24-hour compliance-gap report, serial-number reading, transport security. Open points are confirmed with the specification’s author before integration.

Supports:The rule table on the Türkiye page.

Does not show:Regulatory acceptance; the profile is a technical agreement between integrating parties.

Source: OCPI-TR Custom Modules specification v1.0.0 (ZES, 19 January 2026) and the hub implementation profile docs/integration/TR_CDRADDITIONALS_PROFILE.md · Verified4 October 2026

All evidence records →
parking OCPI 2.3.0 Sender Parking-bay information attached to locations. Offered
1/4 Present in source code
Inspect evidence

OCPI 2.3.0 route table· Source code review

A separate 2.3.0 version endpoint routes bookings, parking bays, payment sessions and token groups, with a translation layer between 2.2.1 and 2.3.0 partners.

Supports:That OCPI 2.3.0 objects are accepted and relayed and that mixed-version partners can be connected.

Does not show:Production use of 2.3.0 with a named partner; payment-session objects do not make the hub a payment institution.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

All evidence records →

Technical prerequisites

What has to be ready on your side before the handshake

Three lists: what every partner needs, this role’s module interfaces and network behaviour. All of it is exercised in the sandbox first, against the charger simulator.

01 · Every partner

  • Versions endpoint (GET /ocpi/versions) and version details (GET /ocpi/2.2.1 or /ocpi/2.3.0)
  • Credentials module, sender and receiver interfaces
  • HTTPS with TLS 1.2 or newer; endpoints reachable from the hub without allow-listing

02 · Interfaces for this role

  • locationsSender
  • tariffsSender
  • sessionsSender
  • cdrsSender
  • tokensReceiver
  • commandsReceiver
  • tr-cdradditionalsSender (Türkiye)

03 · Network behaviour

  • Responses within 10 seconds (connection timeout)
  • Idempotent handling of retried pushes
  • A sandbox round before production: handshake, then each module against the charger simulator

The full handshake sequence and the sandbox: Onboarding and sandbox →

Portal

What you see in the hub portal

Every view is scoped to your party; you never see another partner’s records. Role contexts are kept apart: even when one party runs both roles, views and statements never mix.

Inspect evidence

Hub portal views per role· Source code review

The portal route table defines hub-operator views (directory, map, settlement windows, approvals, partners, contract queue, aggregators, operations, stuck work) and partner views (my statements, my records, my contract, roaming, data quality) with CPO-only sharing sets and tariffs and eMSP-only tokens, sessions, reservations and commands.

Supports:The portal views listed on the role pages.

Does not show:What a given partner sees in production; access is scoped per party. Real screens will be added as separate product-flow records.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

All evidence records →
  • 01My settlement statements
  • 02My invoices (after the financial go-live gate)
  • 03My records: sessions and CDRs
  • 04My contract and relationships
  • 05Sharing sets: which partner sees which location
  • 06My tariffs
  • 07Data quality

Two gates

What you need

The technical gate opens the handshake and data flow; the financial gate opens real money. This list does not replace the participation agreement.

Technical gate

Per partner

For the handshake and data flow

  • Signed roaming participation agreement and data processing agreement
  • Legal name, tax number and, where applicable, charging network operator licence number
  • An OCPI versions endpoint reachable from the hub and a Token A for the handshake
  • Sender implementations for locations, tariffs, sessions and CDRs; receiver for tokens and commands

Financial gate

Once for the hub

For real money to flow

  • tr-cdr-additionals populated on every CDR
  • Collection and invoicing details as set out in the agreement

Until the financial gate closes, settlement statements are produced in dry-run and no invoice is issued: you see the amounts, no money moves.

Sequence

How it proceeds

  1. 01

    Application and agreement

    You apply with your role and versions endpoint; the agreement and DPA are signed; your party is created in the hub directory.

  2. 02

    Sandbox and handshake

    Credentials are exchanged against the sandbox first; each module is exercised with test data and the gaps are listed before anything is live.

  3. 03

    Scope and relationships

    You decide which eMSPs see which sharing set; each relationship is accepted explicitly by both sides before data flows.

  4. 04

    Flow and statements

    Locations, status and tariffs reach your partners; sessions become CDRs; each settlement window closes with a netting statement you can verify against the ledger.

01

Scope is a decision, not a default

Sharing sets group your locations; a relationship with an eMSP points at a set. Narrowing or widening the scope is one operation and every change is written to the audit ledger. A location that is in no set is invisible to every partner.

1/4 Present in source code
Inspect evidence

Fail-closed partner relationships· Source code review

No location, tariff, session, CDR or token flows unless an explicitly accepted, active partner relationship exists between the two parties; publish scope defaults to deny and changes are written to an audit ledger.

Supports:That a completed credentials handshake does not open data flow and that scope is an explicit, auditable decision.

Does not show:Contractual data-sharing permissions; those come from the signed agreement and DPA.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

All evidence records →

02

What the hub does with your CDRs

Each CDR is validated against the tariff and the session, then enters the open settlement window for that partner pair. At close you receive a netting statement; the hub fee is a separate line and is never offset against roaming amounts. Until the financial go-live gate closes, statements are produced in dry-run and no invoice is issued.

1/4 Present in source code
Inspect evidence

Settlement window state machine· Source code review

The clearing platform moves each settlement window through OPEN, GRACE_PERIOD, RECONCILING and CLOSED; late CDRs enter during the grace period and disputes surface before close.

Supports:That settlement periods, netting statements and payment obligations are produced by the platform.

Does not show:That money has moved between partners through the hub: settlement runs in dry-run until the financial go-live gate closes, and invoicing is fenced until then.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

Hash-chained settlement ledger· Source code review

Ledger entries are chained by hash so a statement can be re-verified against its inputs; hub fees are booked as separate lines for each party and never netted against roaming amounts.

Supports:Tamper-evidence of the ledger and the “hub fee outside netting” rule.

Does not show:Fee rates or splits; those are in the participation agreement, not on this site.

Source: ChargeBridge hub source repository (private), reviewed on the date given · Verified4 October 2026

All evidence records →

Frequently asked questions

Do I have to open all my sites to every eMSP on the hub?

No. The default is closed. You create sharing sets and accept relationships one by one; the hub never publishes a location outside an accepted relationship.

My charging software is not Electroop’s. Can I still connect?

Yes. The hub speaks OCPI 2.2.1 and 2.3.0 to any compliant implementation. Electroop products are one of several ways to connect; the hub is operated by E-Gridium independently of which software a partner runs.

Which OCPI version should I implement?

Either. The hub negotiates the version with each partner separately and translates between 2.2.1 and 2.3.0 where objects differ, so your partners’ version is not your constraint.

How are fees charged?

As a percentage per CDR, split between the two parties of a session, booked as its own line in the statement. The rate is in the participation agreement; it is not published here.

How it proceeds

  1. 01Apply with your role and versions endpoint
  2. 02Sign the participation agreement and DPA
  3. 03Handshake in the sandbox, then accept relationships

Connect your network or app once; decide the rest per partner.