Skip to main contentSkip to navigationSkip to search
Skip to main content
Learning Hub/Explorer
Back

Payments

OCPI 2.2.1
Overview

Payments lets a driver pay for charging right at the charge point with a normal bank card, no app and no roaming contract needed. A Payment Terminal Provider owns a Terminal object that maps physical terminals to the CPO's locations and EVSEs, and after a session it sends a Financial Advice Confirmation carrying the real captured amount the invoice needs.

Who sends

PTP (Payment Terminal Provider)

Who receives

CPO (Charge Point Operator)

Key Fields
FieldTypeDescription

terminal_id

CiString(36)

Unique ID of a payment terminal

customer_reference

CiString(36)

Links the terminal to a CSMS, often set at order time

invoice_base_url

URL

Base URL for the downloadable invoice

invoice_creator

InvoiceCreator

Which party (CPO or PTP) creates the invoice

location_ids

CiString(36)[]

Locations assigned to this terminal

Endpoints
GET

/ocpi/2.2.1/payments/terminals/

PUT

/ocpi/2.2.1/payments/terminals/{terminal_id}

PATCH

/ocpi/2.2.1/payments/terminals/{terminal_id}

POST

/ocpi/2.2.1/payments/financial-advice-confirmations/

Live Endpoint Tester

Send requests directly to the local backend and see the response.

Skip to main content