Protocolo aberto

Integre com a rede
PlugrPay via OCPI

Use o protocolo OCPI 2.2.1 para listar eletropostos, autorizar motoristas em roaming e trocar sessões e CDRs com nossa plataforma. Zero lock-in, padrão aberto da indústria EV.

Ver endpoints → Ambiente de teste

O que é OCPI?

O Open Charge Point Interface (OCPI) é um protocolo REST aberto que permite a comunicação entre redes de carregamento elétrico (CPOs) e provedores de mobilidade (EMSPs). Com ele, motoristas de qualquer rede parceira podem usar eletropostos PlugrPay — e vice-versa — sem precisar de contratos bilaterais complexos.

CPO

Charge Point Operator

PlugrPay atua como CPO: disponibiliza os eletropostos e processa as sessões de recarga.

EMSP

E-Mobility Service Provider

A rede parceira atua como EMSP: identifica os motoristas e fatura o consumo.

Roaming

Interoperabilidade

Motoristas de uma rede usam carregadores de outra. O OCPI faz a ponte entre os sistemas.

Como funciona o roaming

4 passos do primeiro contato à sessão de recarga.

01

Handshake de credenciais

As duas redes trocam tokens via GET /credentials. Cada lado guarda o token do parceiro para autenticar chamadas futuras.
02

Sincronização de localidades

A rede parceira faz GET /locations e importa os eletropostos PlugrPay, incluindo coordenadas, conectores e status em tempo real.
03

Autorização do motorista

Quando um motorista apresenta o token (RFID/app), o carregador chama POST /tokens/:uid/authorize. Resposta imediata: ALLOWED ou NOT_ALLOWED.
04

CDR e faturamento

Ao fim da sessão, o CPO publica o CDR (Charge Detail Record) com energia, custo e timestamps. O EMSP usa isso para faturar o motorista.

Endpoints disponíveis

Base URL: https://api.plugrpay.com.br

Método	Caminho	Descrição	Auth
GET	/ocpi/2.2/versions	Versões OCPI suportadas	Público
GET	/ocpi/2.2/credentials	Credenciais e roles do CPO PlugrPay	🔑 x-token
GET	/ocpi/2.2/locations	Lista de eletropostos (Location objects)	🔑 x-token
POST	/ocpi/2.2/tokens/:uid/authorize	Autorização de token de motorista	🔑 x-token
GET	/ocpi/2.2/sessions	Sessões de recarga ativas e históricas	🔑 x-token
GET	/ocpi/2.2/cdrs	Charge Detail Records para faturamento	🔑 x-token

Exemplo — GET /ocpi/2.2/locations

GET https://api.plugrpay.com.br/ocpi/2.2/locations?offset=0&limit=10 HTTP/1.1
Host: api.plugrpay.com.br
x-token: your-ocpi-token
Accept: application/json

HTTP/1.1 200 OK
{
  "status_code": 1000,
  "status_message": "Success",
  "timestamp": "2025-05-16T10:00:00Z",
  "data": [
    {
      "id": "uuid-do-eletroposto",
      "type": "ON_STREET",
      "name": "Shopping Norte EV01",
      "address": "Av. Brasil, 1500",
      "city": "São Paulo",
      "postal_code": "01310-100",
      "country": "BRA",
      "coordinates": {
        "latitude": "-23.561684",
        "longitude": "-46.655981"
      },
      "evses": [
        {
          "uid": "uuid-do-conector",
          "status": "AVAILABLE",
          "connectors": [
            {
              "id": "1",
              "standard": "CCS2",
              "format": "SOCKET",
              "power_type": "AC_3_PHASE",
              "max_voltage": 400,
              "max_amperage": 32,
              "max_electric_power": 22000
            }
          ]
        }
      ],
      "last_updated": "2025-05-16T09:55:00Z"
    }
  ],
  "total_count": 142,
  "limit": 10,
  "offset": 0
}

Autenticação

Usamos o esquema TOKEN_A do OCPI: um token opaco enviado no header x-token em cada requisição.

Parceiro → PlugrPay

O parceiro usa o token que fornecemos durante o cadastro da conexão.

GET https://api.plugrpay.com.br/ocpi/2.2/locations HTTP/1.1
x-token: plugrpay-ocpi-token
Host: api.plugrpay.com.br

PlugrPay → Parceiro

Quando chamamos o parceiro, usamos o token que o parceiro nos forneceu durante o handshake de credenciais.

GET /versions HTTP/1.1
x-token: <token-do-parceiro>
Host: api.parceiro.com.br

Atenção: Todos os endpoints OCPI (exceto /versions) exigem o header x-token. Requisições sem token ou com token inválido recebem HTTP 401 com status_code: 2001.

Ambiente de teste

Use o ambiente de sandbox para validar sua integração sem afetar dados de produção.

Base URL https://api.plugrpay.com.br

Token de teste


plugrpay-ocpi-demo-token

Swagger UI https://api.plugrpay.com.br/ocpi/docs

Teste rápido com curl

# 1. Verificar versões suportadas (sem autenticação)
curl https://api.plugrpay.com.br/ocpi/2.2/versions

# 2. Listar eletropostos com token de teste
curl https://api.plugrpay.com.br/ocpi/2.2/locations \
  -H "x-token: plugrpay-ocpi-demo-token" \
  -H "Accept: application/json"

# 3. Verificar credenciais do CPO
curl https://api.plugrpay.com.br/ocpi/2.2/credentials \
  -H "x-token: plugrpay-ocpi-demo-token"

Pronto para integrar?

Entre em contato com nosso time técnico para receber suas credenciais de produção e iniciar o processo de homologação OCPI.

integradores@plugrpay.com.br Abrir Swagger UI →

Integre com a rede PlugrPay via OCPI