| Method | Path | Summary | Auth |
|---|---|---|---|
| GET | /v1/package-commerce/catalog | List package products purchasable by the authenticated tenant user | Session |
| GET | /v1/package-commerce/orders | List the authenticated tenant user's package orders | Session |
| GET | /v1/package-commerce/orders/{order_id} | Get one visible package order | Session |
| GET | /v1/package-commerce/orders/{order_id}/events | List sanitized order state events in revision order | Session |
| POST | /v1/package-commerce/provider-callbacks/{provider} | Authenticate and apply one raw payment-provider callback | Public |
| POST | /v1/package-commerce/purchases | Purchase a package subscription for the authenticated tenant user | Session |
| GET | /v1/package-commerce/subscriptions | List effective sold-subscription projections owned by the current user | Session |
| POST | /v1/package-commerce/subscriptions/{subscription_id}/downgrade | Downgrade a package immediately or at the next cycle | Session |
| POST | /v1/package-commerce/subscriptions/{subscription_id}/renew | Renew an active package subscription | Session |
| POST | /v1/package-commerce/subscriptions/{subscription_id}/upgrade | Upgrade a package immediately or at the next cycle | Session |
| POST | /v1/package-commerce/traffic-purchases | Purchase a versioned traffic package snapshot | Session |
| GET | /v1/package-commerce/traffic-purchases/{order_id} | Get a sanitized traffic-purchase order and grant result | Session |
Contract file：api/openapi/v1/control.yaml api/control-package-commerce.openapi.yaml