chore(docs): Updated API Reference (v2) (#9437)

Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action

Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>

www/apps/api-reference/specs/admin/components/schemas/BasePaymentCollection.yaml

@@ -1,5 +1,5 @@
 type: object
-description: The payment collection's payment collections.
+description: The payment collection's details.
 x-schemaName: BasePaymentCollection
 required:
   - id
@@ -20,77 +20,41 @@ properties:
   region_id:
     type: string
     title: region_id
-    description: The payment collection's region id.
+    description: The ID of the region this payment collection is associated with.
   amount:
-    oneOf:
-      - type: string
-        title: amount
-        description: The payment collection's amount.
-      - type: number
-        title: amount
-        description: The payment collection's amount.
-      - type: string
-        title: amount
-        description: The payment collection's amount.
-      - $ref: ./IBigNumber.yaml
+    type: number
+    title: amount
+    description: The total amount to be paid.
   authorized_amount:
-    oneOf:
-      - type: string
-        title: authorized_amount
-        description: The payment collection's authorized amount.
-      - type: number
-        title: authorized_amount
-        description: The payment collection's authorized amount.
-      - type: string
-        title: authorized_amount
-        description: The payment collection's authorized amount.
-      - $ref: ./IBigNumber.yaml
+    type: number
+    title: authorized_amount
+    description: The total authorized amount of the collection's payments.
   captured_amount:
-    oneOf:
-      - type: string
-        title: captured_amount
-        description: The payment collection's captured amount.
-      - type: number
-        title: captured_amount
-        description: The payment collection's captured amount.
-      - type: string
-        title: captured_amount
-        description: The payment collection's captured amount.
-      - $ref: ./IBigNumber.yaml
+    type: number
+    title: captured_amount
+    description: The total captured amount of the collection's payments.
   refunded_amount:
-    oneOf:
-      - type: string
-        title: refunded_amount
-        description: The payment collection's refunded amount.
-      - type: number
-        title: refunded_amount
-        description: The payment collection's refunded amount.
-      - type: string
-        title: refunded_amount
-        description: The payment collection's refunded amount.
-      - $ref: ./IBigNumber.yaml
+    type: number
+    title: refunded_amount
+    description: The total refunded amount of the collection's payments.
   completed_at:
-    oneOf:
-      - type: string
-        title: completed_at
-        description: The payment collection's completed at.
-      - type: string
-        title: completed_at
-        description: The payment collection's completed at.
-        format: date-time
+    type: string
+    format: date-time
+    title: completed_at
+    description: The date the payment collection was completed.
   created_at:
     type: string
     format: date-time
     title: created_at
-    description: The payment collection's created at.
+    description: The date the payment collection was created.
   updated_at:
     type: string
     format: date-time
     title: updated_at
-    description: The payment collection's updated at.
+    description: The date the payment collection was updated.
   metadata:
     type: object
-    description: The payment collection's metadata.
+    description: The payment collection's metadata, can hold custom key-value pairs.
   status:
     type: string
     description: The payment collection's status.
@@ -102,7 +66,9 @@ properties:
       - partially_authorized
   payment_providers:
     type: array
-    description: The payment collection's payment providers.
+    description: >-
+      The payment provider used to process the collection's payments and
+      sessions.
     items:
       $ref: ./BasePaymentProvider.yaml
   payment_sessions: