# API Version 2025-11-10

### 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](https://clerk.com/docs/guides/development/upgrading/upgrade-guides/2025-11-10.md)

### 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**. |

> 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](https://clerk.com/docs/guides/development/upgrading/versioning.md#2025-11-10).