Developer Hub

Integrate with
Open Charge Network ™

The fastest way to connect your infrastructure to the global roaming network. Select your role to get started.

CPO Onboarding Guide

Follow these steps to expose your charging stations to the network.

1. Obtain Unique Party ID

IDRO Americas manages the official registry of Party IDs and EVSE-IDs across North, Central and South America, ensuring your network meets interoperability standards and is ready for seamless roaming.

Get Verified at IDRO Americas

2. Credential Exchange (Handshake)

Initiate the OCPI 2.2.1 handshake by sending your credentials to our registration endpoint. You will receive a token (CRED) to authenticate future requests.

bash
curl -X POST https://api.openchargenetwork.io/ocpi/2.2/credentials \
  -H "Authorization: Token YOUR_INITIAL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "YOUR_SERVER_TOKEN",
    "url": "https://your-backend.com/ocpi/versions",
    "roles": [{"role": "CPO", "business_details": {"name": "My CPO"}}]
  }'

3. Publish Your Locations, Chargers and Tariffs

Push your charging station data (EVSEs, Connectors, Coordinates) to the Hub. Open Charge Network ™ automatically broadcasts this to connected eMSPs.

bash
curl -X PUT https://api.openchargenetwork.io/ocpi/2.2/locations/LOC_123 \
  -H "Authorization: Token YOUR_CRED_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "LOC_123",
    "type": "ON_STREET",
    "name": "Downtown Charger 1",
    "address": "123 Main St",
    "city": "Paris",
    "country": "FRA",
    "coordinates": {"latitude": "48.8566", "longitude": "2.3522"},
    "evses": [...]
  }'

4. Be Ready to Receive Commands

Ensure your backend can handle incoming commands from eMSPs, such as `START_SESSION` or `RESERVE_NOW`.

Requirement: Your command endpoint response time must be under 10 seconds to avoid timeouts.

5. Charge and Send the CDR

Charge Detail Record is the description of a concluded charging session with details. Once a session ends, send the CDR to the Hub for billing settlement.

bash
curl -X POST https://api.openchargenetwork.io/ocpi/2.2/cdrs \
  -H "Authorization: Token YOUR_CRED_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "CDR_98765",
    "start_date_time": "2024-03-15T14:00:00Z",
    "stop_date_time": "2024-03-15T15:30:00Z",
    "auth_id": "DE8ACC12",
    "auth_method": "AUTH_REQUEST",
    "total_cost": { "excl_vat": 15.00, "incl_vat": 18.00 },
    "total_energy": 45.5,
    "currency": "EUR",
    "party_id": "FRA",
    "country_code": "FR"
  }'

6. Receive Your Payment

Open Charge Network ™ aggregates all validated CDRs and generates self-billing invoices on your behalf. Payments are settled monthly via bank transfer for all approved roaming sessions.

Automated Clearing: Disputes are handled via the platform's resolution center before the settlement cycle closes.

SDKs & Tools

Need Help?

Our integration engineers are available on Slack to help you debug.

Join Developer Slack