docs fix

interface/api/payments/list.yaml

@@ -1,6 +1,9 @@
 get:
   tags: [Payments]
   summary: List payments in organization
+  description: |
+    Returns organization payments with cursor pagination and optional filters.
+    State filters accept aliases (`accepted`, `settled`, `failed`, etc.) or canonical orchestration states.
   operationId: paymentsList
   security:
     - bearerAuth: []
@@ -11,17 +14,20 @@ get:
     - name: quotation_ref
       in: query
       required: false
+      description: Filter by quotation reference used for execution.
       schema:
         type: string
     - name: created_from
       in: query
       required: false
+      description: Include payments created at or after this RFC3339 timestamp.
       schema:
         type: string
         format: date-time
     - name: created_to
       in: query
       required: false
+      description: Include payments created before this RFC3339 timestamp (must be after `created_from`).
       schema:
         type: string
         format: date-time