Migrate rich billing portals to common billing portals (#1796)

* Migrate rich billing portals to common billing portals

* Use flexible plan

* Add separated endpoint

* Fix Flexible plan in one more place

openapi/components/requestBodies/storefront/PostSubscription.yaml

@@ -1,9 +1,9 @@
 type: object
 required:
-  - richBillingPortalId
+  - billingPortalId
   - items
 properties:
-  richBillingPortalId:
+  billingPortalId:
     type: string
     description: ID of the billing portal.
     maxLength: 50

openapi/components/schemas/BillingPortal.yaml

@@ -117,6 +117,47 @@ properties:
       - active
       - inactive
     default: active
+  plans:
+    type: array
+    minItems: 1
+    description: Details of selected plans.
+    items:
+      type: object
+      properties:
+        plan:
+          $ref: ./FlexiblePlan.yaml
+        status:
+          type: string
+          description: |-
+            Status of the plan in the billing portal.
+            If the status is `archived`, customers can continue using the billing portal,
+            but can not select it as a new item.
+          enum:
+            - active
+            - archived
+          default: active
+          example: active
+  addons:
+    type: array
+    description: Details of selected add-ons.
+    items:
+      type: object
+      description: Add-on plan details.
+      properties:
+        plan:
+          $ref: ./FlexiblePlan.yaml
+        status:
+          type: string
+          description: |-
+            Status of the plan in the billing portal.
+            If the status is `archived`, customers can continue using the billing portal,
+            but can not select it as a new item.
+          enum:
+            - active
+            - archived
+          default: active
+          example: active
+    default: [ ]
   createdTime:
     $ref: ./CreatedTime.yaml
   updatedTime:

openapi/components/schemas/StorefrontBillingPortal.yaml

@@ -87,6 +87,18 @@ properties:
             description: Website terms of service URL.
             type: string
             format: url
+  plans:
+    type: array
+    minItems: 1
+    description: Details of selected plans.
+    items:
+      $ref: ./FlexiblePlan.yaml
+  addons:
+    type: array
+    description: Details of selected add-ons.
+    items:
+      $ref: ./FlexiblePlan.yaml
+    default: [ ]
   createdTime:
     $ref: ./CreatedTime.yaml
   updatedTime:

openapi/components/schemas/StorefrontOrderPreview.yaml

@@ -155,6 +155,6 @@ properties:
       If unset the cheapest applicable shipping rate is chosen.
     writeOnly: true
     $ref: ./ResourceId.yaml
-  richBillingPortalId:
+  billingPortalId:
     description: |-
-      ID of the rich billing portal to validate items against.
+      ID of the billing portal to validate items against.

openapi/components/schemas/StorefrontSubscription.yaml

@@ -416,7 +416,7 @@ properties:
     type: string
     readOnly: true
     maxLength: 255
-  richBillingPortalId:
+  billingPortalId:
     type: string
     description: ID of the billing portal.
     default: null

openapi/components/schemas/Subscription.yaml

@@ -435,7 +435,7 @@ properties:
       If this value is `null`, this field uses risk metadata that is captured when creating the payment token.
     allOf:
       - $ref: ./RiskMetadata.yaml
-  richBillingPortalId:
+  billingPortalId:
     type: string
     description: ID of the billing portal.
     default: null

openapi/openapi.yaml

@@ -1201,10 +1201,6 @@ paths:
     $ref: ./paths/profile.yaml
   /profile/mfa:
     $ref: ./paths/[email protected]
-  /rich-billing-portals:
-    $ref: ./paths/rich-billing-portals.yaml
-  /rich-billing-portals/{id}:
-    $ref: ./paths/rich-billing-portals@{id}.yaml
   '/roles':
     $ref: ./paths/roles.yaml
   '/roles/{id}':
@@ -1321,6 +1317,8 @@ paths:
     $ref: paths/storefront/account@verification@{token}.yaml
   '/storefront/billing-portals/{slug}':
     $ref: paths/storefront/billing-portals@{slug}.yaml
+  '/storefront/experimental/billing-portals/{slug}':
+    $ref: paths/storefront/experimental@billing-portals@{slug}.yaml
   '/storefront/deposit-strategies/{id}':
     $ref: paths/storefront/deposit-strategies@{id}.yaml
   '/storefront/deposit-requests/{id}':
@@ -1389,8 +1387,6 @@ paths:
     $ref: paths/storefront/purchase.yaml
   '/storefront/preview-purchase':
     $ref: paths/storefront/preview-purchase.yaml
-  '/storefront/rich-billing-portals/{id}':
-    $ref: paths/storefront/rich-billing-portals@{id}.yaml
   '/storefront/quotes/{id}':
     $ref: paths/storefront/quotes@{id}.yaml
   '/storefront/quotes/{id}/accept':