Nov 10

API Version 2025-11-10

Category: Billing
Published: Nov 10

New API Version available with Clerk Billing updates

What’s New

Billing API Redesign

Introduces a new /billing path to replace the legacy /commerce endpoints for all billing-related functionality.
Billing amounts are now represented using structured Fee objects instead of top-level fields.
More details: Guide to Upgrading Your API Version

Overview of Breaking Changes

More details can be found in the upgrade guide linked above.

Area	Description	Migration Notes
Field Rename	`payment_source` → `payment_method`	Update all integrations and payload references to use `payment_method`.
Payload Change	Removed top-level `amounts` fields in the `plans` payload	All amount-related info is now structured via associated Fee objects.
Endpoint Change	`/commerce/*` endpoints have been renamed	Use `/billing` endpoints instead. `/commerce` will be removed over time.

Note

We strongly recommend upgrading to version 2025-11-10 as soon as possible to ensure new billing features work as expected. To see which SDK versions support it, click here.