--- title: "Changes to Create a checkout session" method: POST path: "/api/v1/checkout-sessions" --- # Changes to Create a checkout session `POST /api/v1/checkout-sessions` > Every recorded change to this operation, newest first. ## Timeline Changed in 14 of 54 revisions. - **2026-08-12** (v1) `4e013b4e4a8f`: 24 info - **2026-05-23** (v1) `ac42ddd7b4b4`: 1 breaking, 2 warning, 2 info - **2026-05-18** (v1) `0cdc37620ffb`: 4 breaking, 1 info - **2026-03-31** (v1) `ee465c53a423`: 12 info - **2026-03-31** (v1) `560215310a09`: 3 breaking, 6 info - **2026-03-27** (v1) `de35c02bb0d2`: 8 breaking, 3 warning, 10 info - **2026-03-12** (v1) `6d585460beed`: 1 warning - **2026-03-06** (v1) `bfc7b3ed32b2`: 1 warning - **2026-02-23** (v1) `e78cbe818dc6`: 1 breaking, 4 info - **2026-02-19** (v1) `1bbd84c95e41`: 5 breaking, 2 warning - **2026-02-05** (v1) `f9c417ec1ed4`: 2 info - **2026-01-28** (v1) `44bcc86fb202`: 1 breaking, 2 warning, 1 info - **2026-01-19** (v1) `7d4a46169b06`: 1 info - **2025-07-09** (v1) `dece17f86f99`: 1 breaking ## Changes - **2026-08-12** (v1) `4e013b4e4a8f`: 24 info - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became nullable - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became nullable - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became nullable - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became nullable - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became nullable - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became nullable - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became nullable - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became nullable - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became nullable - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became nullable - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became nullable - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became nullable - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became optional - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became optional - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became optional - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became optional - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became optional - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became optional - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became optional - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became optional - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became optional - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became optional - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became optional - the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became optional - **2026-05-23** (v1) `ac42ddd7b4b4`: 1 breaking, 2 warning, 2 info - the `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref` request property type changed from `object` to no type - removed the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref/id` - removed the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref/name` - added discriminator to `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref` request property - added `#/components/schemas/ExistingProductRef, #/components/schemas/NewProductRef` to the `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref` request property `oneOf` list - **2026-05-18** (v1) `0cdc37620ffb`: 4 breaking, 1 info - added the new required request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref/id` - added the new required request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref/name` - removed `#/components/schemas/ExistingProductRef, #/components/schemas/NewProductRef` from the `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref` request property `oneOf` list - the `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref` request property type changed from no type to `object` - removed discriminator from `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref` request property - **2026-03-31** (v1) `ee465c53a423`: 12 info - request discriminator property name changed for `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property from `discriminator` to `type` - request discriminator property name changed for `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry` request property from `discriminator` to `type` - request discriminator property name changed for `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing` request property from `discriminator` to `type` - request discriminator property name changed for `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model` request property from `discriminator` to `type` - request discriminator property name changed for `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry` request property from `discriminator` to `type` - request discriminator property name changed for `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing` request property from `discriminator` to `type` - request discriminator property name changed for `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model` request property from `discriminator` to `type` - request discriminator property name changed for `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref` request property from `discriminator` to `type` - request discriminator property name changed for `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref/oneOf[#/components/schemas/NewProductRef]/fee_structure` request property from `fee_type` to `type` - request discriminator property name changed for `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry` request property from `discriminator` to `type` - request discriminator property name changed for `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing` request property from `discriminator` to `type` - request discriminator property name changed for `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model` request property from `discriminator` to `type` - **2026-03-31** (v1) `560215310a09`: 3 breaking, 6 info - removed `subschema #1, subschema #2, subschema #3` from the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` request property `oneOf` list - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` from the `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref/oneOf[#/components/schemas/NewProductRef]/fee_structure` request property `oneOf` list - added `#/components/schemas/OnlinePaymentMethodConfig, #/components/schemas/BankTransferPaymentMethodConfig, #/components/schemas/ExternalPaymentMethodConfig` to the `session/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property `oneOf` list for the response status `200` - added discriminator to `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref/oneOf[#/components/schemas/NewProductRef]/fee_structure` request property - added discriminator to `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` request property - added `#/components/schemas/OnlinePaymentMethodConfig, #/components/schemas/BankTransferPaymentMethodConfig, #/components/schemas/ExternalPaymentMethodConfig` to the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` request property `oneOf` list - added `#/components/schemas/RateFeeStructure, #/components/schemas/SlotFeeStructure, #/components/schemas/CapacityFeeStructure, #/components/schemas/UsageFeeStructure, #/components/schemas/ExtraRecurringFeeStructure, #/components/schemas/OneTimeFeeStructure` to the `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref/oneOf[#/components/schemas/NewProductRef]/fee_structure` request property `oneOf` list - added discriminator to `session/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property for the response status `200` - removed `subschema #1, subschema #2, subschema #3` from the `session/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property `oneOf` list for the response status `200` - **2026-03-27** (v1) `de35c02bb0d2`: 8 breaking, 3 warning, 10 info - the request property `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` became not nullable - the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry` request property type changed from `object` to no type - the `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry` request property type changed from `object` to no type - the `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref` request property type changed from `object` to no type - the `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry` request property type changed from `object` to no type - the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` request property type changed from `string, null` to no type - added `#/components/schemas/BankAccountId, subschema #1` to the `session/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` response property `oneOf` list for the response status `200` - the `session/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` response's property type changed from `string, null` to no type for status `200` - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `400` - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `401` - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `500` - added discriminator to `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry` request property - added discriminator to `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry` request property - added discriminator to `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref` request property - added discriminator to `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry` request property - added `#/components/schemas/BankAccountId, subschema #1` to the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` request property `oneOf` list - added `#/components/schemas/ExistingPriceRef, #/components/schemas/PriceInput` to the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry` request property `oneOf` list - added `#/components/schemas/ExistingPriceRef, #/components/schemas/PriceInput` to the `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry` request property `oneOf` list - added `#/components/schemas/ExistingPriceRef, #/components/schemas/PriceInput` to the `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry` request property `oneOf` list - added `#/components/schemas/ExistingProductRef, #/components/schemas/NewProductRef` to the `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref` request property `oneOf` list - added the non-success response with the status `429` - **2026-03-12** (v1) `6d585460beed`: 1 warning - added the new `ADDON_PURCHASE` enum value to the `session/checkout_type` response property for the response status `200` - **2026-03-06** (v1) `bfc7b3ed32b2`: 1 warning - added the new `PLAN_CHANGE` enum value to the `session/checkout_type` response property for the response status `200` - **2026-02-23** (v1) `e78cbe818dc6`: 1 breaking, 4 info - removed `#/components/schemas/SubscriptionAddOnOverride` from the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property `oneOf` list - added the new optional request property `add_ons/items/quantity` - added `PRICE_OVERRIDE` discriminator mapping keys to the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property - removed `OVERRIDE` discriminator mapping keys from the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property - added `#/components/schemas/SubscriptionAddOnPriceOverride` to the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property `oneOf` list - **2026-02-19** (v1) `1bbd84c95e41`: 5 breaking, 2 warning - added the new required request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/name` - added the new required request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/price_entry` - added the new required request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/product_ref` - added the new required request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/name` - added the new required request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/price_entry` - removed the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/component` - removed the request property `components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/component` - **2026-02-05** (v1) `f9c417ec1ed4`: 2 info - added the new optional request property `payment_methods_config` - added the optional property `session/payment_methods_config` to the response with the `200` status - **2026-01-28** (v1) `44bcc86fb202`: 1 breaking, 2 warning, 1 info - the `customer_id` request property format changed from `MeteroidId` to `CustomerId or customer alias` - removed the request property `activation_condition` - removed the request property `payment_strategy` - the endpoint scheme security `bearer_auth` was added to the API - **2026-01-19** (v1) `7d4a46169b06`: 1 info - endpoint added - **2025-07-09** (v1) `dece17f86f99`: 1 breaking - api path removed without deprecation --- [Operation](https://skmtc.dev/meteroid-oss/apis/meteroid/docs/api/v1/checkout-sessions/post.md) - [API](https://skmtc.dev/meteroid-oss/apis/meteroid.md) - [Page](https://skmtc.dev/meteroid-oss/apis/meteroid/changes/api/v1/checkout-sessions/post)