@ampeco/public-api-mcp 3.260.0 → 3.261.0

package/dist/generated/build-stats.json

@@ -1,13 +1,13 @@
 {
-  "totalEndpoints": 686,
-  "originalSize": 6626711,
-  "optimizedSize": 1863124,
-  "reductionPercent": 71.88,
-  "buildDuration": 2595,
+  "totalEndpoints": 687,
+  "originalSize": 6649224,
+  "optimizedSize": 1871567,
+  "reductionPercent": 71.85,
+  "buildDuration": 1665,
   "responseSchemas": {
-    "total": 686,
-    "withSchemas": 686,
-    "totalSchemaSize": 3803561,
-    "averageSchemaSize": 5545
+    "total": 687,
+    "withSchemas": 687,
+    "totalSchemaSize": 3815360,
+    "averageSchemaSize": 5554
   }
 }

package/dist/generated/endpoints.json

@@ -1130,7 +1130,7 @@
                 "paymentMethodId": {
                   "type": "string",
                   "nullable": true,
-                  "description": "The ID of the payment method, as returned by the payment method listing (User / Payment Method / Listing). When left empty or null, it would be determined by the system - either \"balance\" or \"subscription\" (in case the the user has an active post-paid subscription for home charging sessions and the charge point is a home charger). When it is NOT empty or null, userId is required."
+                  "description": "The ID of the payment method, as returned by the payment method listing (User / Payment Method / Listing) or the contextual payment options lookup (User / payment options). When it is not empty or null, `userId` is required. Choosing balance explicitly requires `paymentMethodId: \"balance\"`. Omitting this field, or sending an empty or null value, does not explicitly select balance. The system attempts automatic selection in this order: the charge point's corporate account, an applicable subscription, the user's default personal payment method, then the user's default corporate account. Balance is the fallback only when none of these applies. For OCPI or Hubject roaming EVSEs, an omitted, empty or null payment method is rejected; provide an explicit `paymentMethodId`."
                 },
                 "externalSessionId": {
                   "type": "string",
@@ -1230,7 +1230,7 @@
                 "paymentMethodId": {
                   "type": "string",
                   "nullable": true,
-                  "description": "The ID of the payment method, as returned by the payment method listing (User / Payment Method / Listing). When left empty or null, it would be determined by the system - either \"balance\" or \"subscription\" (in case the the user has an active post-paid subscription for home charging sessions and the charge point is a home charger). When it is NOT empty or null, userId is required."
+                  "description": "The ID of the payment method, as returned by the payment method listing (User / Payment Method / Listing) or the contextual payment options lookup (User / payment options). When it is not empty or null, `userId` is required. Choosing balance explicitly requires `paymentMethodId: \"balance\"`. Omitting this field, or sending an empty or null value, does not explicitly select balance. The system attempts automatic selection in this order: the charge point's corporate account, an applicable subscription, the user's default personal payment method, then the user's default corporate account. Balance is the fallback only when none of these applies. For OCPI or Hubject roaming EVSEs, an omitted, empty or null payment method is rejected; provide an explicit `paymentMethodId`."
                 },
                 "externalSessionId": {
                   "type": "string",
@@ -3039,7 +3039,7 @@
                 "paymentMethodId": {
                   "type": "string",
                   "nullable": true,
-                  "description": "The ID of the payment method, as returned by the payment method listing (User / Payment Method / Listing). When left empty or null, it would be determined by the system - either \"balance\" or \"subscription\" (in case the the user has an active post-paid subscription for home charging sessions and the charge point is a home charger). When it is NOT empty or null, userId is required."
+                  "description": "The ID of the payment method, as returned by the payment method listing (User / Payment Method / Listing) or the contextual payment options lookup (User / payment options). When it is not empty or null, `userId` is required. Choosing balance explicitly requires `paymentMethodId: \"balance\"`. Omitting this field, or sending an empty or null value, does not explicitly select balance. The system attempts automatic selection in this order: the charge point's corporate account, an applicable subscription, the user's default personal payment method, then the user's default corporate account. Balance is the fallback only when none of these applies. For OCPI or Hubject roaming EVSEs, an omitted, empty or null payment method is rejected; provide an explicit `paymentMethodId`."
                 },
                 "externalSessionId": {
                   "type": "string",
@@ -5704,7 +5704,7 @@
           "description": "The record is not found"
         },
         "409": {
-          "description": "Conflict - The request cannot be completed due to a conflict with the current state of the resource. Possible errors: * Session payment cannot be retried - Payment status must be either 'failed' or 'partially paid' * Session total amount is below the minimum transaction amount required by the payment provider * Session billing status is not completed * Session is not finalized"
+          "description": "Conflict - The request cannot be completed due to a conflict with the current state of the resource. Possible errors: * Session payment cannot be retried - Payment status must be either 'failed' or 'partially paid' * Session total amount is below the minimum transaction amount required by the payment provider * Session billing status is not completed * Session is not finalized * No payment processor is configured for the session user's stored payment method"
         },
         "422": {
           "description": "The payload you provided is invalid"
@@ -59896,7 +59896,7 @@
                       "type": "number",
                       "format": "decimal",
                       "nullable": true,
-                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision."
+                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision. For energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails."
                     },
                     "dayPricePerKwh": {
                       "type": "number",
@@ -60661,7 +60661,7 @@
                       "description": "Present when `discountMode=per_element` and `discountReferenceType` is `base_tariff` or `specific_tariff`. Omitted otherwise. Each entry configures a discount for a specific fee component of the referenced tariff. At least one entry is required. Prohibited when `discountReferenceType=roaming_tariff`."
                     }
                   },
-                  "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise."
+                  "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise. Tariff list and detail responses describe tariff configuration, not a price for a specific charging context. Discounts referencing `specific_tariff` can return discounted pricing from the configured source tariff. Discounts referencing `base_tariff` or `roaming_tariff` return an empty `pricing` object because these reads do not supply the source tariff group or roaming source needed to calculate an effective price. A price derived for an earlier session does not select the source for a later tariff read."
                 },
                 "stopSession": {
                   "type": "object",
@@ -61033,7 +61033,7 @@
                       "type": "number",
                       "format": "decimal",
                       "nullable": true,
-                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision."
+                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision. For energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails."
                     },
                     "dayPricePerKwh": {
                       "type": "number",
@@ -61798,7 +61798,7 @@
                       "description": "Present when `discountMode=per_element` and `discountReferenceType` is `base_tariff` or `specific_tariff`. Omitted otherwise. Each entry configures a discount for a specific fee component of the referenced tariff. At least one entry is required. Prohibited when `discountReferenceType=roaming_tariff`."
                     }
                   },
-                  "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise."
+                  "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise. Tariff list and detail responses describe tariff configuration, not a price for a specific charging context. Discounts referencing `specific_tariff` can return discounted pricing from the configured source tariff. Discounts referencing `base_tariff` or `roaming_tariff` return an empty `pricing` object because these reads do not supply the source tariff group or roaming source needed to calculate an effective price. A price derived for an earlier session does not select the source for a later tariff read."
                 },
                 "stopSession": {
                   "type": "object",
@@ -62196,7 +62196,7 @@
                       "type": "number",
                       "format": "decimal",
                       "nullable": true,
-                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision."
+                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision. For energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails."
                     },
                     "dayPricePerKwh": {
                       "type": "number",
@@ -62961,7 +62961,7 @@
                       "description": "Present when `discountMode=per_element` and `discountReferenceType` is `base_tariff` or `specific_tariff`. Omitted otherwise. Each entry configures a discount for a specific fee component of the referenced tariff. At least one entry is required. Prohibited when `discountReferenceType=roaming_tariff`."
                     }
                   },
-                  "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise."
+                  "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise. Tariff list and detail responses describe tariff configuration, not a price for a specific charging context. Discounts referencing `specific_tariff` can return discounted pricing from the configured source tariff. Discounts referencing `base_tariff` or `roaming_tariff` return an empty `pricing` object because these reads do not supply the source tariff group or roaming source needed to calculate an effective price. A price derived for an earlier session does not select the source for a later tariff read."
                 },
                 "stopSession": {
                   "type": "object",
@@ -63404,7 +63404,7 @@
                       "type": "number",
                       "format": "decimal",
                       "nullable": true,
-                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision."
+                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision. For energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails."
                     },
                     "dayPricePerKwh": {
                       "type": "number",
@@ -64355,7 +64355,7 @@
                       "type": "number",
                       "format": "decimal",
                       "nullable": true,
-                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision."
+                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision. For energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails."
                     },
                     "dayPricePerKwh": {
                       "type": "number",
@@ -73517,6 +73517,65 @@
         }
       }
     },
+    {
+      "path": "/public-api/resources/users/v1.1/{user}/payment-options",
+      "method": "GET",
+      "operationId": "userPaymentOptionsReadV1_1",
+      "summary": "User / payment options",
+      "description": "Get the payment options available to a user for starting a session at the specified EVSE. Options are returned in display order, with at most one option marked as preselected. An empty array means no payment options are available for this context. The offer is limited to tokenized payment methods, corporate accounts, subscriptions and balance. Preselection is calculated within this supported subset; it may differ from a client that offers additional payment categories. This read-only lookup does not create or change business state, reserve or authorize a session, or guarantee that a session can start. Preselection is a recommendation, not a payment selection for a subsequent start request. Pass the chosen `paymentMethodId` explicitly to a start action; choosing balance requires `paymentMethodId: \"balance\"`. Both query parameters are required: `context` must be `session_start`, and `evseId` must be an integer database ID greater than or equal to 1. The `user` route parameter must be an integer database ID. Missing, unsupported or malformed query values and malformed user identifiers return 422 before resource lookup. The route value takes precedence over any `user` query parameter. The caller must have permission to list payment methods (403 otherwise), and both the user and EVSE must be visible to the authenticated token-owner or impersonated admin. Unknown or inaccessible integer IDs return 404. This lookup does not require permission to start sessions. ⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.1 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. This notice applies only to GET `users/v1.1/{user}/payment-options`; other users v1.1 operations remain version-locked.",
+      "tags": [
+        "resource / users"
+      ],
+      "parameters": {
+        "path": {
+          "user": {
+            "type": "integer",
+            "required": true
+          }
+        },
+        "query": {
+          "context": {
+            "description": "The context in which the payment options will be used.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "session_start"
+              ],
+              "example": "session_start",
+              "description": "The context for computing the user's payment options. Only session start is supported."
+            },
+            "required": true
+          },
+          "evseId": {
+            "description": "The ID of the EVSE at which the user intends to start a session.",
+            "type": "integer",
+            "minimum": 1,
+            "required": true,
+            "example": 123
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "Success"
+        },
+        "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"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
     {
       "path": "/public-api/resources/utilities/v1.0",
       "method": "GET",
@@ -75344,7 +75403,7 @@
   ],
   "info": {
     "title": "Public API",
-    "version": "3.260.0",
+    "version": "3.261.0",
     "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": [
@@ -75358,18 +75417,18 @@
       }
     }
   ],
-  "buildTimestamp": "2026-10-07T10:47:09.087Z",
+  "buildTimestamp": "2026-10-08T08:30:58.512Z",
   "stats": {
-    "totalEndpoints": 686,
-    "originalSize": 6626711,
-    "optimizedSize": 1863124,
-    "reductionPercent": 71.88,
-    "buildDuration": 2595,
+    "totalEndpoints": 687,
+    "originalSize": 6649224,
+    "optimizedSize": 1871567,
+    "reductionPercent": 71.85,
+    "buildDuration": 1665,
     "responseSchemas": {
-      "total": 686,
-      "withSchemas": 686,
-      "totalSchemaSize": 3803561,
-      "averageSchemaSize": 5545
+      "total": 687,
+      "withSchemas": 687,
+      "totalSchemaSize": 3815360,
+      "averageSchemaSize": 5554
     }
   }
 }

package/dist/generated/response-schemas.json

@@ -18649,7 +18649,7 @@
                   "pricePerKwh": {
                     "type": "number",
                     "format": "decimal",
-                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.",
+                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.\n\nFor energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails.\n",
                     "nullable": true
                   },
                   "dayPricePerKwh": {
@@ -19336,7 +19336,7 @@
               },
               "discountTariffSettings": {
                 "type": "object",
-                "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n",
+                "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n\nTariff list and detail responses describe tariff configuration, not a price for a specific charging context. Discounts referencing `specific_tariff` can return discounted pricing from the configured source tariff. Discounts referencing `base_tariff` or `roaming_tariff` return an empty `pricing` object because these reads do not supply the source tariff group or roaming source needed to calculate an effective price. A price derived for an earlier session does not select the source for a later tariff read.\n",
                 "properties": {
                   "discountReferenceType": {
                     "type": "string",
@@ -155847,7 +155847,7 @@
                   "pricePerKwh": {
                     "type": "number",
                     "format": "decimal",
-                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.",
+                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.\n\nFor energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails.\n",
                     "nullable": true
                   },
                   "dayPricePerKwh": {
@@ -156534,7 +156534,7 @@
               },
               "discountTariffSettings": {
                 "type": "object",
-                "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n",
+                "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n\nTariff list and detail responses describe tariff configuration, not a price for a specific charging context. Discounts referencing `specific_tariff` can return discounted pricing from the configured source tariff. Discounts referencing `base_tariff` or `roaming_tariff` return an empty `pricing` object because these reads do not supply the source tariff group or roaming source needed to calculate an effective price. A price derived for an earlier session does not select the source for a later tariff read.\n",
                 "properties": {
                   "discountReferenceType": {
                     "type": "string",
@@ -157035,7 +157035,7 @@
                     "pricePerKwh": {
                       "type": "number",
                       "format": "decimal",
-                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.",
+                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.\n\nFor energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails.\n",
                       "nullable": true
                     },
                     "dayPricePerKwh": {
@@ -157722,7 +157722,7 @@
                 },
                 "discountTariffSettings": {
                   "type": "object",
-                  "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n",
+                  "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n\nTariff list and detail responses describe tariff configuration, not a price for a specific charging context. Discounts referencing `specific_tariff` can return discounted pricing from the configured source tariff. Discounts referencing `base_tariff` or `roaming_tariff` return an empty `pricing` object because these reads do not supply the source tariff group or roaming source needed to calculate an effective price. A price derived for an earlier session does not select the source for a later tariff read.\n",
                   "properties": {
                     "discountReferenceType": {
                       "type": "string",
@@ -158372,7 +158372,7 @@
                   "pricePerKwh": {
                     "type": "number",
                     "format": "decimal",
-                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.",
+                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.\n\nFor energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails.\n",
                     "nullable": true
                   },
                   "dayPricePerKwh": {
@@ -159059,7 +159059,7 @@
               },
               "discountTariffSettings": {
                 "type": "object",
-                "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n",
+                "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n\nTariff list and detail responses describe tariff configuration, not a price for a specific charging context. Discounts referencing `specific_tariff` can return discounted pricing from the configured source tariff. Discounts referencing `base_tariff` or `roaming_tariff` return an empty `pricing` object because these reads do not supply the source tariff group or roaming source needed to calculate an effective price. A price derived for an earlier session does not select the source for a later tariff read.\n",
                 "properties": {
                   "discountReferenceType": {
                     "type": "string",
@@ -159584,7 +159584,7 @@
                   "pricePerKwh": {
                     "type": "number",
                     "format": "decimal",
-                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.",
+                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.\n\nFor energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails.\n",
                     "nullable": true
                   },
                   "dayPricePerKwh": {
@@ -160271,7 +160271,7 @@
               },
               "discountTariffSettings": {
                 "type": "object",
-                "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n",
+                "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n\nTariff list and detail responses describe tariff configuration, not a price for a specific charging context. Discounts referencing `specific_tariff` can return discounted pricing from the configured source tariff. Discounts referencing `base_tariff` or `roaming_tariff` return an empty `pricing` object because these reads do not supply the source tariff group or roaming source needed to calculate an effective price. A price derived for an earlier session does not select the source for a later tariff read.\n",
                 "properties": {
                   "discountReferenceType": {
                     "type": "string",
@@ -160784,7 +160784,7 @@
                   "pricePerKwh": {
                     "type": "number",
                     "format": "decimal",
-                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.",
+                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.\n\nFor energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails.\n",
                     "nullable": true
                   },
                   "dayPricePerKwh": {
@@ -161471,7 +161471,7 @@
               },
               "discountTariffSettings": {
                 "type": "object",
-                "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n",
+                "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n\nTariff list and detail responses describe tariff configuration, not a price for a specific charging context. Discounts referencing `specific_tariff` can return discounted pricing from the configured source tariff. Discounts referencing `base_tariff` or `roaming_tariff` return an empty `pricing` object because these reads do not supply the source tariff group or roaming source needed to calculate an effective price. A price derived for an earlier session does not select the source for a later tariff read.\n",
                 "properties": {
                   "discountReferenceType": {
                     "type": "string",
@@ -162059,7 +162059,7 @@
                   "pricePerKwh": {
                     "type": "number",
                     "format": "decimal",
-                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.",
+                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.\n\nFor energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails.\n",
                     "nullable": true
                   },
                   "dayPricePerKwh": {
@@ -162746,7 +162746,7 @@
               },
               "discountTariffSettings": {
                 "type": "object",
-                "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n",
+                "description": "Discount configuration for discount based tariffs. Present only when `type=discount based`, omitted otherwise.\n\nTariff list and detail responses describe tariff configuration, not a price for a specific charging context. Discounts referencing `specific_tariff` can return discounted pricing from the configured source tariff. Discounts referencing `base_tariff` or `roaming_tariff` return an empty `pricing` object because these reads do not supply the source tariff group or roaming source needed to calculate an effective price. A price derived for an earlier session does not select the source for a later tariff read.\n",
                 "properties": {
                   "discountReferenceType": {
                     "type": "string",
@@ -163299,7 +163299,7 @@
                     "pricePerKwh": {
                       "type": "number",
                       "format": "decimal",
-                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.",
+                      "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.\n\nFor energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails.\n",
                       "nullable": true
                     },
                     "dayPricePerKwh": {
@@ -164309,7 +164309,7 @@
                   "pricePerKwh": {
                     "type": "number",
                     "format": "decimal",
-                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.",
+                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.\n\nFor energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails.\n",
                     "nullable": true
                   },
                   "dayPricePerKwh": {
@@ -165292,7 +165292,7 @@
                   "pricePerKwh": {
                     "type": "number",
                     "format": "decimal",
-                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.",
+                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.\n\nFor energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails.\n",
                     "nullable": true
                   },
                   "dayPricePerKwh": {
@@ -166296,7 +166296,7 @@
                   "pricePerKwh": {
                     "type": "number",
                     "format": "decimal",
-                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.",
+                    "description": "Price per kWh. Up to 5 digits after the decimal point depending on the currency precision.\n\nFor energy time-of-use tariffs, tariff responses calculate this value from the tariff's fallback electricity rate at the time of calculation, including applicable markup and subsidy rules. It is not a charge-point-specific quote or a historical session price. When `chargePointElectricityRate` is enabled, charging can use the charge point's electricity rate instead, so the charged price can differ. The value is null if the fallback rate is unavailable or the calculation fails.\n",
                     "nullable": true
                   },
                   "dayPricePerKwh": {
@@ -202837,6 +202837,147 @@
       }
     }
   },
+  "userPaymentOptionsReadV1_1": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.1 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed.\n\nThis notice applies only to GET `users/v1.1/{user}/payment-options`; other users v1.1 operations remain version-locked.\n",
+        "required": [
+          "data"
+        ],
+        "properties": {
+          "data": {
+            "type": "object",
+            "required": [
+              "options"
+            ],
+            "properties": {
+              "options": {
+                "type": "array",
+                "description": "Available payment options in display order. At most one option is preselected; the array may be empty.",
+                "items": {
+                  "type": "object",
+                  "required": [
+                    "paymentMethodId",
+                    "type",
+                    "isPreselected"
+                  ],
+                  "properties": {
+                    "paymentMethodId": {
+                      "type": "string",
+                      "description": "The identifier accepted as paymentMethodId by the session start actions. Use the value as returned, including any prefix. The balance option uses the explicit identifier `balance`.",
+                      "example": "1234"
+                    },
+                    "type": {
+                      "type": "string",
+                      "enum": [
+                        "tokenized",
+                        "corporate",
+                        "subscription",
+                        "balance"
+                      ],
+                      "description": "The type of payment option available for starting a session:\n  * `tokenized` — A saved payment method, including saved wallet cards and eligible stored bank debit methods.\n  * `corporate` — An eligible corporate billing account for this user and EVSE.\n  * `subscription` — An eligible subscription installment payment method.\n  * `balance` — The user's balance payment option.\n",
+                      "example": "tokenized"
+                    },
+                    "isPreselected": {
+                      "type": "boolean",
+                      "description": "Whether this option is recommended for this context. This does not select payment for a subsequent start request.",
+                      "example": true
+                    }
+                  }
+                },
+                "example": [
+                  {
+                    "paymentMethodId": "1234",
+                    "type": "tokenized",
+                    "isPreselected": true
+                  },
+                  {
+                    "paymentMethodId": "corporate:1235",
+                    "type": "corporate",
+                    "isPreselected": false
+                  },
+                  {
+                    "paymentMethodId": "subscription_installment:1234",
+                    "type": "subscription",
+                    "isPreselected": false
+                  },
+                  {
+                    "paymentMethodId": "balance",
+                    "type": "balance",
+                    "isPreselected": false
+                  }
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
+    "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"
+          }
+        }
+      }
+    },
+    "422": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          },
+          "errors": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "429": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
   "listUtilities": {
     "200": {
       "schema": {