OpenAPI 3.1.0

EdgePay Edge Gateway API

POS-based EV charging payment orchestration platform for Turkey. Handles payment intents, ad-hoc charging sessions, terminal management, attestation, OCPI 2.2.1 roaming, and webhook notifications.

39 Endpoints
8 Resource Groups
v1.0.0 Version
Developmenthttps://api.dev.cloops.io Staginghttps://staging-api.edgepay.com.tr Productionhttps://api.edgepay.com.tr OpenAPI JSON
Authentication

Bearer Token (JWT)

Include a JWT token in the Authorization header.
Authorization: Bearer <token>

API Key

Pass your API key via the header.
X-API-Key: <key>

Endpoints

Payments

5

Payment intent lifecycle (create → authorize → capture/void)

POST /v1/payment-intents Create a new payment intent
GET /v1/payment-intents/{id} Get payment intent by ID
POST /v1/payment-intents/{id}/authorize Authorize a payment intent
POST /v1/payment-intents/{id}/capture Capture an authorised payment
POST /v1/payment-intents/{id}/void Void an authorised payment

Charges

5

Ad-hoc EV charging sessions

POST /v1/adhoc-charges/start Start an ad-hoc charging session
PUT /v1/adhoc-charges/{id}/progress Update charging session progress
POST /v1/adhoc-charges/{id}/complete Complete a charging session
GET /v1/adhoc-charges/{id} Get charge session by ID
GET /v1/adhoc-charges List charging sessions

Terminals

6

Terminal registration, health, and status

POST /v1/terminals Register a new EV charging terminal
GET /v1/terminals List terminals
GET /v1/terminals/{id} Get terminal by ID
POST /v1/terminals/{id}/health-events Report terminal health
PUT /v1/terminals/{id}/status Update terminal status
GET /v1/terminals/stats Get terminal fleet statistics

Webhooks

7

Webhook subscription and delivery management

POST /api/v1/webhooks Register a webhook subscription
GET /api/v1/webhooks List webhook subscriptions
GET /api/v1/webhooks/{id} Get subscription details
PUT /api/v1/webhooks/{id} Update subscription
DELETE /api/v1/webhooks/{id} Deactivate subscription
GET /api/v1/webhooks/{id}/deliveries List deliveries for a subscription
POST /api/v1/webhooks/{id}/test Send test webhook event

Charging Infrastructure

11

Station-CPMS mappings, connector status, adapter health, CPMS configuration

GET /v1/charging-infrastructure/mappings List station-CPMS mappings
POST /v1/charging-infrastructure/mappings Create a station-CPMS mapping
GET /v1/charging-infrastructure/mappings/{id} Get station-CPMS mapping by ID
PATCH /v1/charging-infrastructure/mappings/{id} Update a station-CPMS mapping
DELETE /v1/charging-infrastructure/mappings/{id} Delete a station-CPMS mapping
POST /v1/charging-infrastructure/mappings/{id}/test Test CPMS connectivity for a station
GET /v1/charging-infrastructure/connectors List connector statuses
GET /v1/charging-infrastructure/connectors/summary Get connector status summary
GET /v1/charging-infrastructure/adapters/health Get CPMS adapter health
GET /v1/charging-infrastructure/config Get CPMS configuration
PATCH /v1/charging-infrastructure/config/{adapterType} Update CPMS adapter config

Health

5

Health checks and readiness probes

GET /health Basic health check
GET /health/ready Readiness probe (K8s)
GET /health/live Liveness probe (K8s)
GET /health/detailed Detailed health with component status
GET /metrics Prometheus metrics endpoint