Payments
Payments in OCPI 2.2.1
Payments exchanges Terminal mappings and Financial Advice Confirmations between the CPO and Payment Terminal Provider (PTP). This is the separate Direct Payment 2.2.1 extension. It defines PTP-side and CPO-side interfaces; these are not a universal Sender/Receiver pair.
Sources (5)
Example payload · assigned-terminal
{
"terminal_id": "EXAMPLE-TERMINAL",
"location_ids": [
"EXAMPLE-LOCATION"
],
"evse_uids": [
"EXAMPLE-EVSE"
],
"last_updated": "2026-01-01T13:00:00Z"
}Example payload · successful-financial-advice
{
"id": "EXAMPLE-FINANCIAL-ADVICE",
"authorization_reference": "EXAMPLE-AUTHORIZATION",
"total_costs": {
"excl_vat": 4,
"incl_vat": 4.4
},
"currency": "EUR",
"eft_data": [
"Example successful capture"
],
"capture_status_code": "SUCCESS",
"last_updated": "2026-01-01T13:00:00Z"
}Which endpoints does this module define?
These paths illustrate the requests. Use the URLs advertised by your partner, replace the placeholders and choose the matching interface. A listed method does not establish that this site's simulator implements it.
PTP
Read Terminals.
GET/ocpi/ 2.2.1/ payments/ terminals/ Assign locations to a Terminal.
PATCH/ocpi/ 2.2.1/ payments/ terminals/ {terminal_id} Update a Terminal.
PUT/ocpi/ 2.2.1/ payments/ terminals/ {terminal_id} Read financial advice confirmations.
GET/ocpi/ 2.2.1/ payments/ financial-advice-confirmations/
Sources (4)
CPO
Read Terminals stored by the CPO.
GET/ocpi/ 2.2.1/ payments/ terminals/ Create a Terminal.
POST/ocpi/ 2.2.1/ payments/ terminals/ Read confirmations stored by the CPO.
GET/ocpi/ 2.2.1/ payments/ financial-advice-confirmations/ Create a financial advice confirmation.
POST/ocpi/ 2.2.1/ payments/ financial-advice-confirmations/
Sources (4)
Try an endpoint
Send a request to this site's OCPI endpoints and read the answer. It never reaches your own system.