Added support for collecting Recurring Order payments with Checkout in public beta

7 October 2026

API

New feature

CartsOrdersPaymentsGraphQL

You can now configure a recurring Cart so that commercetools Checkout collects payment for each subsequent Order before that Order is created. If the payment fails, no Order is created and the Recurring Order transitions to the Failed RecurringOrderState.

Without this configuration, subsequent Orders continue to be created as soon as they are due, and collecting payment remains your responsibility afterwards.

This feature is in public beta.

To learn more, see Payments in the Recurring Orders overview.

This release includes the following changes:

[API] Updated the Carts API with the following:
- Added the recurringPaymentConfiguration field to the Cart type.
- Added the Set RecurringPaymentStrategy, Set RecurringPaymentConfiguration, Add RecurringPaymentAllocation, and Remove RecurringPaymentAllocation update actions.
- Added the following types: RecurringPaymentConfiguration, RecurringPaymentConfigurationDraft, RecurringPaymentAllocation, PaymentAllocationDraft, PaymentStrategy, Allocation, AllocationDraft, RelativeAllocation, RelativeAllocationDraft, AbsoluteAllocation, and AbsoluteAllocationDraft.
[GraphQL API] Added the following types to the GraphQL schema: RecurringPaymentConfiguration, RecurringPaymentConfigurationDraft, RecurringPaymentAllocation, PaymentAllocationDraft, PaymentStrategy, AllocationInterface, AllocationInputDraft, Relative, RelativeInputDraft, Absolute, AbsoluteInputDraft, SetRecurringPaymentStrategy, SetRecurringPaymentConfiguration, AddRecurringPaymentAllocation, and RemoveRecurringPaymentAllocation.
[GraphQL API] Added the recurringPaymentConfiguration field to the Cart type.
[GraphQL API] Added the setRecurringPaymentStrategy, setRecurringPaymentConfiguration, addRecurringPaymentAllocation, and removeRecurringPaymentAllocation input fields to the CartUpdateAction type.