oas: [15/n] improve oas schemas (#9216)

Improve OAS schemas [15/n]

Note: validation error will be fixed once #9218 is merged

www/utils/generated/oas-output/schemas/BaseCapture.ts

@@ -1,8 +1,33 @@
 /**
  * @schema BaseCapture
  * type: object
- * description: The capture's captures.
+ * description: The details of a captured payment.
  * x-schemaName: BaseCapture
+ * required:
+ *   - id
+ *   - amount
+ *   - created_at
+ *   - payment
+ * properties:
+ *   id:
+ *     type: string
+ *     title: id
+ *     description: The payment capture's ID.
+ *   amount:
+ *     type: number
+ *     title: amount
+ *     description: The captured amount.
+ *   created_at:
+ *     type: string
+ *     format: date-time
+ *     title: created_at
+ *     description: The date the capture was created.
+ *   created_by:
+ *     type: string
+ *     title: created_by
+ *     description: The ID of the user that captured the payment.
+ *   payment:
+ *     $ref: "#/components/schemas/BasePayment"
  * 
 */