@ampeco/public-api-mcp 3.231.2 → 3.232.1

package/dist/generated/build-stats.json

@@ -1,13 +1,13 @@
 {
-  "totalEndpoints": 623,
-  "originalSize": 5470731,
-  "optimizedSize": 1541469,
-  "reductionPercent": 71.82,
-  "buildDuration": 2152,
+  "totalEndpoints": 624,
+  "originalSize": 5492259,
+  "optimizedSize": 1545702,
+  "reductionPercent": 71.86,
+  "buildDuration": 1538,
   "responseSchemas": {
-    "total": 623,
-    "withSchemas": 623,
-    "totalSchemaSize": 3141172,
-    "averageSchemaSize": 5042
+    "total": 624,
+    "withSchemas": 624,
+    "totalSchemaSize": 3144146,
+    "averageSchemaSize": 5039
   }
 }

package/dist/generated/endpoints.json

@@ -5016,6 +5016,142 @@
         }
       }
     },
+    {
+      "path": "/public-api/actions/transaction/v1.0/{transaction}/create-pre-authorization",
+      "method": "POST",
+      "operationId": "transactionCreatePreAuthorization",
+      "summary": "Transaction / Create Pre-Authorization",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. Creates a pre-authorisation — a hold, never an immediate charge — for a pending ad hoc transaction, using the payment processor set on the transaction (Worldline or Stripe), and returns what you need to collect the customer's payment. Amount and currency come from the transaction. Repeated calls return the existing pre-authorisation instead of creating a second one.",
+      "tags": [
+        "action / transaction"
+      ],
+      "requestBody": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "oneOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "processor": {
+                      "type": "string",
+                      "enum": [
+                        "worldline"
+                      ],
+                      "description": "The payment processor of the transaction."
+                    },
+                    "paymentProductId": {
+                      "type": "integer",
+                      "description": "Worldline payment product id selecting the payment rail (e.g. TWINT, Bancontact)."
+                    },
+                    "returnUrl": {
+                      "type": "string",
+                      "description": "URL Worldline redirects the customer back to after completing the hosted-checkout page."
+                    },
+                    "locale": {
+                      "type": "string",
+                      "description": "Locale used to render the Worldline hosted-checkout page (e.g. \"en\", \"de\")."
+                    },
+                    "paymentProductFilters": {
+                      "type": "object",
+                      "properties": {
+                        "restrictTo": {
+                          "type": "object",
+                          "properties": {
+                            "products": {
+                              "type": "array",
+                              "items": {
+                                "type": "integer"
+                              }
+                            },
+                            "groups": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            }
+                          },
+                          "description": "Restrict the hosted-checkout page to the listed products and groups."
+                        },
+                        "exclude": {
+                          "type": "object",
+                          "properties": {
+                            "products": {
+                              "type": "array",
+                              "items": {
+                                "type": "integer"
+                              }
+                            },
+                            "groups": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            }
+                          },
+                          "description": "Exclude the listed products and groups from the hosted-checkout page."
+                        }
+                      },
+                      "description": "Optional Worldline payment-product restrictions applied to the hosted-checkout page."
+                    }
+                  },
+                  "required": [
+                    "processor",
+                    "returnUrl"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Create-pre-authorization request for a transaction whose payment processor is Worldline. The pre-authorisation is created as a Worldline hosted-checkout page; the response returns the URL to redirect the customer to."
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "processor": {
+                      "type": "string",
+                      "enum": [
+                        "stripe"
+                      ],
+                      "description": "The payment processor of the transaction."
+                    }
+                  },
+                  "required": [
+                    "processor"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Create-pre-authorization request for a transaction whose payment processor is Stripe. No card details are sent in this request — the response returns a PaymentIntent client secret, and the customer's card is collected client-side (for example with Stripe Elements) to complete the pre-authorisation."
+                }
+              ]
+            }
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "The pre-authorisation was created, or already existed from an earlier call — repeated calls return the same payment data. The response contains what you need to collect the customer's payment."
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "409": {
+          "description": "The request could not be completed due to a conflict with the current state of the resource. The operation may succeed if retried."
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "424": {
+          "description": "The requested operation cannot be completed because it depends on communication with an external system (e.g., charge point) that is currently disconnected or unreachable"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
     {
       "path": "/public-api/actions/transactions/v1.0/{transaction}/issue-invoice",
       "method": "POST",
@@ -24970,6 +25106,14 @@
                   ],
                   "description": "Only list Id tags in this type"
                 },
+                "rfidStandard": {
+                  "type": "string",
+                  "enum": [
+                    "iso14443",
+                    "iso15693"
+                  ],
+                  "description": "RFID card standard."
+                },
                 "partnerId": {
                   "type": "string",
                   "format": "integer",
@@ -25075,6 +25219,14 @@
                     "mac_address"
                   ]
                 },
+                "rfidStandard": {
+                  "type": "string",
+                  "enum": [
+                    "iso14443",
+                    "iso15693"
+                  ],
+                  "description": "RFID card standard."
+                },
                 "vehicleType": {
                   "type": "string",
                   "enum": [
@@ -25254,6 +25406,15 @@
                     "mac_address"
                   ]
                 },
+                "rfidStandard": {
+                  "type": "string",
+                  "enum": [
+                    "iso14443",
+                    "iso15693"
+                  ],
+                  "nullable": true,
+                  "description": "RFID card standard."
+                },
                 "vehicleType": {
                   "type": "string",
                   "enum": [
@@ -26949,11 +27110,12 @@
                     "product_offerings",
                     "ev_driver_ux",
                     "security",
+                    "reporting",
                     "roaming",
                     "other"
                   ],
                   "example": "network",
-                  "description": "Issue category: - **network**: Network connectivity or communication issues - **payments_billing**: Payment processing or billing-related issues - **product_offerings**: Issues with product features or tariff offerings - **ev_driver_ux**: EV driver user experience issues - **security**: Security-related concerns or incidents - **roaming**: Roaming-related issues - **other**: Issues not covered by other categories"
+                  "description": "Issue category: - **network**: Network connectivity or communication issues - **payments_billing**: Payment processing or billing-related issues - **product_offerings**: Issues with product features or tariff offerings - **ev_driver_ux**: EV driver user experience issues - **security**: Security-related concerns or incidents - **reporting**: Reporting or analytics issues - **roaming**: Roaming-related issues - **other**: Issues not covered by other categories"
                 },
                 "severity": {
                   "type": "string",
@@ -27094,11 +27256,12 @@
                     "product_offerings",
                     "ev_driver_ux",
                     "security",
+                    "reporting",
                     "roaming",
                     "other"
                   ],
                   "example": "network",
-                  "description": "Issue category: - **network**: Network connectivity or communication issues - **payments_billing**: Payment processing or billing-related issues - **product_offerings**: Issues with product features or tariff offerings - **ev_driver_ux**: EV driver user experience issues - **security**: Security-related concerns or incidents - **roaming**: Roaming-related issues - **other**: Issues not covered by other categories"
+                  "description": "Issue category: - **network**: Network connectivity or communication issues - **payments_billing**: Payment processing or billing-related issues - **product_offerings**: Issues with product features or tariff offerings - **ev_driver_ux**: EV driver user experience issues - **security**: Security-related concerns or incidents - **reporting**: Reporting or analytics issues - **roaming**: Roaming-related issues - **other**: Issues not covered by other categories"
                 },
                 "severity": {
                   "type": "string",
@@ -27326,11 +27489,12 @@
                     "product_offerings",
                     "ev_driver_ux",
                     "security",
+                    "reporting",
                     "roaming",
                     "other"
                   ],
                   "example": "network",
-                  "description": "Issue category: - **network**: Network connectivity or communication issues - **payments_billing**: Payment processing or billing-related issues - **product_offerings**: Issues with product features or tariff offerings - **ev_driver_ux**: EV driver user experience issues - **security**: Security-related concerns or incidents - **roaming**: Roaming-related issues - **other**: Issues not covered by other categories"
+                  "description": "Issue category: - **network**: Network connectivity or communication issues - **payments_billing**: Payment processing or billing-related issues - **product_offerings**: Issues with product features or tariff offerings - **ev_driver_ux**: EV driver user experience issues - **security**: Security-related concerns or incidents - **reporting**: Reporting or analytics issues - **roaming**: Roaming-related issues - **other**: Issues not covered by other categories"
                 },
                 "severity": {
                   "type": "string",
@@ -70017,7 +70181,7 @@
   ],
   "info": {
     "title": "Public API",
-    "version": "3.231.2",
+    "version": "3.232.1",
     "description": "The Public API provides server-to-server integration capabilities for your EV charging platform.\n\n**Authentication.** Existing integrations continue to work unchanged — long-lived UUID admin tokens are sent in `Authorization: Bearer ...` with no exchange required. Two security schemes are documented for OpenAPI client tooling, both resulting in the same Bearer header at the wire level:\n   - `bearerAuth` — the token in the `Authorization: Bearer ...` header is either a long-lived UUID admin token (issued via the admin UI, used directly) or a short-lived access token previously obtained via OAuth.\n   - `oauth2ClientCredentials` - a `client_id` / `client_secret` pair should be exchanged for a short-lived access token at `/public-api/oauth/token` per RFC 6749 Section 4.4 (Client Credentials Grant), and the short-lived token should be used in the `Authorization: Bearer ...` header. The OAuth `client_secret` itself cannot be sent directly as a bearer token — it must be exchanged first.\n"
   },
   "servers": [
@@ -70031,18 +70195,18 @@
       }
     }
   ],
-  "buildTimestamp": "2026-08-12T13:04:34.699Z",
+  "buildTimestamp": "2026-08-17T08:28:28.680Z",
   "stats": {
-    "totalEndpoints": 623,
-    "originalSize": 5470731,
-    "optimizedSize": 1541469,
-    "reductionPercent": 71.82,
-    "buildDuration": 2152,
+    "totalEndpoints": 624,
+    "originalSize": 5492259,
+    "optimizedSize": 1545702,
+    "reductionPercent": 71.86,
+    "buildDuration": 1538,
     "responseSchemas": {
-      "total": 623,
-      "withSchemas": 623,
-      "totalSchemaSize": 3141172,
-      "averageSchemaSize": 5042
+      "total": 624,
+      "withSchemas": 624,
+      "totalSchemaSize": 3144146,
+      "averageSchemaSize": 5039
     }
   }
 }

package/dist/generated/response-schemas.json

@@ -10431,6 +10431,165 @@
       }
     }
   },
+  "transactionCreatePreAuthorization": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "oneOf": [
+              {
+                "type": "object",
+                "description": "Create-pre-authorization result for a transaction whose payment processor is Worldline.\nRedirect the customer to `redirectUrl` to complete the hosted-checkout\npre-authorisation.\n",
+                "properties": {
+                  "processor": {
+                    "type": "string",
+                    "enum": [
+                      "worldline"
+                    ],
+                    "description": "The payment processor that produced this result."
+                  },
+                  "redirectUrl": {
+                    "type": "string",
+                    "description": "Worldline hosted-checkout URL the portal redirects the customer to in order to complete the pre-authorisation."
+                  },
+                  "reference": {
+                    "type": "string",
+                    "description": "Worldline hosted checkout id stored on the transaction as the provider reference."
+                  }
+                },
+                "required": [
+                  "processor",
+                  "redirectUrl",
+                  "reference"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "description": "Create-pre-authorization result for a transaction whose payment processor is Stripe.\nConfirm the PaymentIntent client-side using `clientSecret` to complete the\npre-authorisation.\n",
+                "properties": {
+                  "processor": {
+                    "type": "string",
+                    "enum": [
+                      "stripe"
+                    ],
+                    "description": "The payment processor that produced this result."
+                  },
+                  "clientSecret": {
+                    "type": "string",
+                    "description": "Stripe PaymentIntent client secret the portal uses to confirm the pre-authorisation via Stripe Elements."
+                  },
+                  "paymentIntentId": {
+                    "type": "string",
+                    "description": "Stripe PaymentIntent id (pi_…) stored on the transaction as the provider reference."
+                  }
+                },
+                "required": [
+                  "processor",
+                  "clientSecret",
+                  "paymentIntentId"
+                ],
+                "additionalProperties": false
+              }
+            ],
+            "discriminator": {
+              "propertyName": "processor"
+            }
+          }
+        },
+        "required": [
+          "data"
+        ]
+      }
+    },
+    "401": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "403": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string",
+            "default": "This action is unauthorized."
+          }
+        }
+      }
+    },
+    "404": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "409": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "422": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          },
+          "errors": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "424": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "429": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
   "transactionIssueInvoice": {
     "401": {
       "schema": {
@@ -58823,6 +58982,14 @@
                     "emaid"
                   ]
                 },
+                "rfidStandard": {
+                  "description": "RFID card standard.",
+                  "type": "string",
+                  "enum": [
+                    "iso14443",
+                    "iso15693"
+                  ]
+                },
                 "vehicleType": {
                   "type": "string",
                   "nullable": true,
@@ -59106,6 +59273,14 @@
                   "emaid"
                 ]
               },
+              "rfidStandard": {
+                "description": "RFID card standard.",
+                "type": "string",
+                "enum": [
+                  "iso14443",
+                  "iso15693"
+                ]
+              },
               "vehicleType": {
                 "type": "string",
                 "nullable": true,
@@ -59274,6 +59449,14 @@
                   "emaid"
                 ]
               },
+              "rfidStandard": {
+                "description": "RFID card standard.",
+                "type": "string",
+                "enum": [
+                  "iso14443",
+                  "iso15693"
+                ]
+              },
               "vehicleType": {
                 "type": "string",
                 "nullable": true,
@@ -59463,6 +59646,14 @@
                   "emaid"
                 ]
               },
+              "rfidStandard": {
+                "description": "RFID card standard.",
+                "type": "string",
+                "enum": [
+                  "iso14443",
+                  "iso15693"
+                ]
+              },
               "vehicleType": {
                 "type": "string",
                 "nullable": true,
@@ -63058,10 +63249,11 @@
                     "product_offerings",
                     "ev_driver_ux",
                     "security",
+                    "reporting",
                     "roaming",
                     "other"
                   ],
-                  "description": "Issue category:\n- **network**: Network connectivity or communication issues\n- **payments_billing**: Payment processing or billing-related issues\n- **product_offerings**: Issues with product features or tariff offerings\n- **ev_driver_ux**: EV driver user experience issues\n- **security**: Security-related concerns or incidents\n- **roaming**: Roaming-related issues\n- **other**: Issues not covered by other categories\n",
+                  "description": "Issue category:\n- **network**: Network connectivity or communication issues\n- **payments_billing**: Payment processing or billing-related issues\n- **product_offerings**: Issues with product features or tariff offerings\n- **ev_driver_ux**: EV driver user experience issues\n- **security**: Security-related concerns or incidents\n- **reporting**: Reporting or analytics issues\n- **roaming**: Roaming-related issues\n- **other**: Issues not covered by other categories\n",
                   "example": "network"
                 },
                 "severity": {
@@ -63325,10 +63517,11 @@
                   "product_offerings",
                   "ev_driver_ux",
                   "security",
+                  "reporting",
                   "roaming",
                   "other"
                 ],
-                "description": "Issue category:\n- **network**: Network connectivity or communication issues\n- **payments_billing**: Payment processing or billing-related issues\n- **product_offerings**: Issues with product features or tariff offerings\n- **ev_driver_ux**: EV driver user experience issues\n- **security**: Security-related concerns or incidents\n- **roaming**: Roaming-related issues\n- **other**: Issues not covered by other categories\n",
+                "description": "Issue category:\n- **network**: Network connectivity or communication issues\n- **payments_billing**: Payment processing or billing-related issues\n- **product_offerings**: Issues with product features or tariff offerings\n- **ev_driver_ux**: EV driver user experience issues\n- **security**: Security-related concerns or incidents\n- **reporting**: Reporting or analytics issues\n- **roaming**: Roaming-related issues\n- **other**: Issues not covered by other categories\n",
                 "example": "network"
               },
               "severity": {
@@ -63553,10 +63746,11 @@
                   "product_offerings",
                   "ev_driver_ux",
                   "security",
+                  "reporting",
                   "roaming",
                   "other"
                 ],
-                "description": "Issue category:\n- **network**: Network connectivity or communication issues\n- **payments_billing**: Payment processing or billing-related issues\n- **product_offerings**: Issues with product features or tariff offerings\n- **ev_driver_ux**: EV driver user experience issues\n- **security**: Security-related concerns or incidents\n- **roaming**: Roaming-related issues\n- **other**: Issues not covered by other categories\n",
+                "description": "Issue category:\n- **network**: Network connectivity or communication issues\n- **payments_billing**: Payment processing or billing-related issues\n- **product_offerings**: Issues with product features or tariff offerings\n- **ev_driver_ux**: EV driver user experience issues\n- **security**: Security-related concerns or incidents\n- **reporting**: Reporting or analytics issues\n- **roaming**: Roaming-related issues\n- **other**: Issues not covered by other categories\n",
                 "example": "network"
               },
               "severity": {
@@ -63834,10 +64028,11 @@
                   "product_offerings",
                   "ev_driver_ux",
                   "security",
+                  "reporting",
                   "roaming",
                   "other"
                 ],
-                "description": "Issue category:\n- **network**: Network connectivity or communication issues\n- **payments_billing**: Payment processing or billing-related issues\n- **product_offerings**: Issues with product features or tariff offerings\n- **ev_driver_ux**: EV driver user experience issues\n- **security**: Security-related concerns or incidents\n- **roaming**: Roaming-related issues\n- **other**: Issues not covered by other categories\n",
+                "description": "Issue category:\n- **network**: Network connectivity or communication issues\n- **payments_billing**: Payment processing or billing-related issues\n- **product_offerings**: Issues with product features or tariff offerings\n- **ev_driver_ux**: EV driver user experience issues\n- **security**: Security-related concerns or incidents\n- **reporting**: Reporting or analytics issues\n- **roaming**: Roaming-related issues\n- **other**: Issues not covered by other categories\n",
                 "example": "network"
               },
               "severity": {